#include <nwdsconn.h>N_EXTERN_LIBRARY (NWDSCCODE) NWDSScanConnsForTrees (NWDSContextHandle context, nuint numOfPtrs, pnuint numOfTrees, ppnstr8 treeBufPtrs);
NWDSScanConnsForTrees scans existing connections and returns a list of tree names associated with those connections. The list does not include duplicates and is sorted by the defined collation table.
The numOfPtrs parameter indicates the maximum number of strings that may be assigned by NWDSScanConnsForTrees. The numOfTrees parameter specifies the number of strings assigned to treeBufPtrs. In the event that numOfTrees exceeds numOfPtrs, numOfPtrs strings will be assigned, numOfTrees will be returned, and an error code of ERR_BUFFER_BULL will be returned.
The tree names returned imply authentication since a connection isn't designated as Bindery or NDS until authentication.
The context parameter is used to determine the character type for the tree name (that is, local code page or Unicode).
Connection (Directory Support)