NWDSDuplicateContextHandle

Allocates memory for a new context structure and initializes it with values copied from the source context structure.

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) NWDSDuplicateContextHandle  ( 
     NWDSContextHandle          srcContextHandle,  
     NWDSContextHandle N_FAR   *destContextHandle);

Pascal

  uses netwin32 
   
  Function NWDSDuplicateContextHandle 
    (srcContextHandle : NWDSContextHandle; 
     Var destContextHandle : NWDSContextHandle 
  ) : NWDSCCODE;

Parameters

srcContextHandle: (IN) Specifies the context handle referencing the structure to be duplicated.
destContextHandle: (OUT) Points to the newly created context handle.

Return Values

These are common return values.

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

Remarks

NWDSDuplicateContextHandle allocates storage for a new context structure and copies the values of the source context structure referenced by srcContextHandle to the newly allocated context structure. If the srcContextHandle is invalid, allocation of a new context structure is still attempted. In this case, the default values of NWDSCreateContextHandle will be used to initialize the new context structure.

NCP Calls

None