NWDSGetBinderyContext

Returns the setting of the bindery context set on the server identified by connHandle.

Local Servers:blocking

Remote Servers:blocking

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 <nwdsmisc.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSGetBinderyContext  ( 
     NWDSContextHandle   context,  
     NWCONN_HANDLE       connHandle,  
     pnuint8             BinderyEmulationContext);

Pascal

  uses netwin32 
   
  Function NWDSGetBinderyContext 
    (context : NWDSContextHandle; 
     connHandle : NWCONN_HANDLE; 
     BinderyEmulationContext : pnuint8 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
connHandle: (IN) Specifies the NetWare server connection handle.
binderyEmulationContext: (OUT) Points to a bindery context string.

Return Values

These are common return values.

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

Remarks

The connHandle parameter is the connection handle to the server in which you are interested.

The binderyEmulationContext parameter must have sufficient space allocated to receive the value. For partial dot names, the DCV_CANONICALIZE_NAMES flag determines whether an RDN or a DN is returned for the bindery context. See Section 1.1, Context Handles for more information.

The bindery context specifies a location in eDirectory where a bindery connection is allowed to see objects in eDirectory. A bindery connection can see objects only in the eDirectory container defined by the server’s bindery context.

Bindery context is set on NetWare 4.x and 5.x servers by using the SET BINDERY CONTEXT command at the server console.

NCP Calls

0x2222 104 04 Return Bindery Context