NWGetPreferredConnName(3nw)


NWGetPreferredConnName -- gets the name of the preferred connection

Synopsis

   #include <nwnet.h> 
   see also 
   #include <nwndscon.h> 
   

NWCCODE N_API NWGetPreferredConnName (nuint8 N_FAR * preferredName, nuint8 N_FAR * preferredType);

Description

The parameters are as follows:

preferredName
(OUT) Points to the buffer where the preferred name is stored.

preferredType
(OUT) Points to the preferred name type set [NWNDS_CONNECTION (Preferred Tree Name) or 0 (Preferred Server)].

Return values

0x0000
SUCCESSFUL

Notices

NWGetPreferredConnName will only work if VLMs are loaded; it will not work with NETX.

If both preferredType names are set by API calls or NET.CFG, the order is determined at VLM load time.

Defaults are Preferred Tree Name, then Preferred Server.

If a Preferred Tree Name is not specified, the Preferred Server will be returned and preferredType will be zero (Preferred Server). However, if a Preferred Tree Name is specified in NET.CFG, or if NWSetPreferredDSTree is called, preferredName will be the Preferred Tree Name and the server type will beNWNDS_CONNECTION (Preferred Tree Name). If BIND.VLM is loaded before NDS.VLM, the opposite is true.

Services

Connection (Directory Support)

NCP calls

None

References

NWSetPreferredDSTree(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.