NWDSDuplicateContext(3nw)


NWDSDuplicateContext -- creates a Directory context and initializes it to the same settings as an existing Directory Context

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsdc.h> 
   

NWDSContextHandle N_API NWDSDuplicateContext (NWDSContextHandle oldContext);

Description

The parameters are as follows:

oldContext
(IN) Specifies the Directory context to duplicate.

Return values

0x0000
SUCCESSFUL

0xFEB8
ERR_CONTEXT_CREATION

Notices

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

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.

Services

Directory

NCP calls

None

References

NWDSCreateContext(3nw), NWDSFreeContext(3nw), NWDSSetContext(3nw), NWDSGetContext(3nw),


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