NWDSGetContext

Returns information about an NDS context handle.

NetWare Server:4.x, 5.x, 6.x

Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP

Library:Cross-Platform NDS (NET*.*)

Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsdc.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSGetContext  ( 
     NWDSContextHandle   context,  
     nint                key,  
     nptr                value);

Pascal

  uses netwin32 
   
  Function NWDSGetContext 
    (context : NWDSContextHandle; 
     key : nint; 
     value : nptr 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the context handle to be queried.
key: (IN) Specifies the information to be retrieved (see Section 5.6, Context Keys and Flags).
value: (OUT) Points to the context handle information.

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

Applications cannot directly access context handle information. Applications must use the NWDSGetContext function to retrieve context information.

The key parameter specifies the type of information to retrieve, and the value parameter points to the information retrieved. The value parameter must point to a variable that matches the data type specified by the key parameter. For data types and defined keys, see Section 5.6, Context Keys and Flags.

The NWDSGetContext function must be called repetitively to retrieve information contained in multiple keys.

NCP Calls

None