#include <nwclxcon.h>
N_EXTERN_LIBRARY NWRCODE NWCCOpenConnByName (NWCONN_HANDLE startConnHandle, pnstr8 name, nuint nameFormat, nuint openState, nuint reserved, pNWCONN_HANDLE connHandle);
startConnHandle is the connection to use when resolving a name. For instance, if the name is a bindery name, the requester will scan the bindery of the given connection for the required server name.
startConnHandle can also be zero if you don't care which connection should be used to resolve the name. This value can also be 1 which causes each connection to be used until the name is resolved successfully. Only existing connections are used when -1 is specified, except when no connections exist yet, one will be established.
name points to the structure containing the name of the file server to which to connect. The format and length of these strings are defined by nameFormat.
nameFormat can have the following values:
NWC_NAME_FORMAT_WILD may be Ored with the other values or used alone. When ORed with another value, the wild value indicates an unmarked alternative is acceptable when the name cannot be found in the selected name server. When used alone, it indicates any name service may be used, but the preferred name service as configured in the client will be used first.
openState can have the following values:
nameFormat can have the following values:
Connection