NWSetPreferredDSTree(3nw)


NWSetPreferredDSTree -- sets preferred Directory Server tree name in requester's tables

Synopsis

   #include <nwnet.h> 
   

see also

#include <nwdstype.h> #include <nwndscon.h>

NWCCODE N_API NWSetPreferredDSTree (nuint16 length, nuint8 N_FAR * tree);

Description

The parameters are as follows:

length
(IN) Specifies the length of the tree name.

tree
(IN) Points to the Directory server tree name.

Return values

0x0000
SUCCESSFUL

0x8836
INVALID_PARAMETER

Notices

NWSetPreferredDSTreesets a tree name for future Directory Services calls. The tree name may also be set in NET.CFG. The maximum name length is 32 characters. If the server name is too long, INVALID_PARAMETER is returned.

NWGetPreferredDSServer creates the connection attachment to the server specified in NWSetPreferredDSTree.

To call NWSetPreferredDSTree in DOS or in Windows, VLMs must be running. Netx does not support NWSetPreferredDSTree and will return an error if VLMs are not running.

Services

Connection (Directory Support)

NCP calls

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