GetThreadContextSpecifier

Returns the CLIB context that is used by callback routines scheduled by the specified thread

Local Servers:nonblocking
Remote Servers:N/A
Classification:4.x, 5.x, 6.x
Service:Thread

Syntax

  #include <nwthread.h>  
   
  int GetThreadContextSpecifier  (  
     int   threadID);

Parameters

threadID
(IN) Specifies the ID of the thread whose context specifier you want to get.

Return Values

The following table lists return values and descriptions.

Value

Hex

Name

-1

 

EFAILURE

0

(0x00)

NO_CONTEXT

1

(0x01)

USE_CURRENT_CONTEXT

Other values are valid thread group IDs.

Remarks

Many of the functions that are registered as callbacks run as OS threads. These threads need CLIB context to use the NetWare API functions. The function SetThreadContextSpecifier can be set to give these threads context when the callbacks are registered. This function lets you find out what those settings were.

If additional callbacks are registered, their context run as part of the thread group that corresponds to the thread group ID that is returned by this function.

See Also

SetThreadContextSpecifier