NWDSCreateContextHandle

Creates a new context handle and initializes it with default values.

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)  NWDSCreateContextHandle  ( 
     NWDSContextHandle N_FAR   *newHandle);

Pascal

  uses netwin32 
   
  Function NWDSCreateContextHandle 
    (Var newHandle : NWDSContextHandle 
  ) : NWDSCCODE;

Parameters

newHandle: (OUT) Points to the newly created context handle.

Return Values

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

Remarks

NWDSCreateContextHandle allocates a new context handle and initializes the context handle with default values (see Section 5.7, Default Context Key Values).

The number of context handles an application can create is limited only by available resources. Creation can fail if there is insufficient memory or the Unicode tables have not been initialized (see NWInitUnicodeTables (Unicode)).

To view or modify context information, use the NWDSGetContext and the NWDSSetContext functions.

NCP Calls

None