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.