NWDSDuplicateContext (obsolete 03/99)

Creates an NDS context and initializes it to the same settings as an existing NDS context. This function is obsolete. Call NWDSDuplicateContextHandle instead.

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)  NWDSDuplicateContext  ( 
     NWDSContextHandle   oldContext);
  

Pascal

  uses netwin32 
   
  Function NWDSDuplicateContext 
    (oldContext : NWDSContextHandle 
  ) : NWDSContextHandle;
  

Parameters

oldContext

(IN) Specifies the NDS context to duplicate.

Return Values

These are common return values; see NDS Return Values for more information.

0x0000 0000

SUCCESSFUL

0xFFFF FEB8

ERR_CONTEXT_CREATION

Remarks

If successful, NWDSDuplicateContext returns a value identifying the created NDS context. The newly created context will have a copy of the contents of the NDS context specified by oldContext. If oldContext does not reference a valid NDS context, the new context will be initialized with default values as in NWDSCreateContextHandle.

The advantage in calling NWDSDuplicateContext is that it copies the context settings of the existing context. If you are using context settings that are not the default, NWDSDuplicateContext lets you avoid making some additional calls to modify the default context settings.

NCP Calls

See Also

NWDSCreateContextHandle, NWDSFreeContext, NWDSSetContext, NWDSGetContext