ReturnBlockOfTasks

Frees a block of task numbers

Local Servers:blocking
Remote Servers:nonblocking
Classification:3.x, 4.x, 5.x, 6.x
Service:Connection Number and Task Management

Syntax

  #include <nwcntask.h>  
   
  int ReturnBlockOfTasks  (  
     LONG   startingTask,   
     LONG   numberOfTasks);

Parameters

startingTask
(IN) Specifies the first task number in the set.
numberOfTasks
(IN) Specifies the number of task numbers in the set.

Return Values

The following table lists return values and descriptions.

Value

Hex

Name

Description

0

(0x00)

ESUCCESS

Block of task numbers are freed.

NetWare Error

Not successful.

Remarks

The ReturnBlockOfTasks function frees one or more task numbers the NLM previously allocated with the SetCurrentTask or AllocateBlockOfTasks function. An NLM should call the ReturnBlockOfTasks function to return the allocated task numbers before unloading.

See Also

AllocateBlockOfTasks, SetCurrentTask