NWDSDuplicateContextHandle(3nw)


NWDSDuplicateContextHandle -- allocates memory for a new context structure and initializes it with values copied from the source context structure

Synopsis

   #include <nwdsdc.h> 
   

N_EXTERN_LIBRARY (NWDSCCODE) NWDSDuplicateContextHandle (NWDSContextHandle srcContextHandle, NWDSContextHandle N_FAR *destContextHandle);

Description

The parameters are as follows:

srcContextHandle
(IN) Specifies the context handle referencing the structure to be duplicated.

destContextHandle
(OUT) Points to the newly created context handle.

Return values

0x0000
SUCCESS

Non-zero Value
Error

Notices

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.

NWDSResetNDSStatistics differs from NWDSDuplicateContext in that the return code may now specify codes indicative of the reason for the failure.

Services

Directory

NCP calls

None

References

NWDSCreateContextHandle(3nw), NWDSDuplicateContext(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.