NWSetPreferredDSTree

Sets the preferred eDirectory tree name in the requester’s tables.

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 <nwndscon.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE) NWSetPreferredDSTree  ( 
     nuint16   length,  
     pnuint8   treeName);

Pascal

  uses netwin32 
   
  Function NWSetPreferredDSTree 
    (length : nuint16; 
     treeName : pnuint8 
  ) : NWCCODE;

Parameters

length

(IN) Specifies the length of the tree name.

treeName

(IN) Points to the eDirectory tree name.

Return Values

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

0x0000 0000

SUCCESSFUL

0x8836

INVALID_PARAMETER

Remarks

NWSetPreferredDSTree sets a tree name for future eDirectory functions. The tree name may also be set in net.cfg. The maximum name length is 32 characters. If the tree name is too long, INVALID_PARAMETER is returned.

NCP Calls