NWDSScanConnsForTrees(3nw)


NWDSScanConnsForTrees -- scans existing connections for tree names

Synopsis

   #include <nwdsconn.h> 
   

N_EXTERN_LIBRARY (NWDSCCODE) NWDSScanConnsForTrees (NWDSContextHandle context, nuint numOfPtrs, pnuint numOfTrees, ppnstr8 treeBufPtrs);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context for the request.

numOfPtrs
(IN) Specifies the number of pointers available in treeBufPtrs.

numOfTrees
(OUT) Points to the number of tree names that can be returned by NWDSScanConnsForTrees.

treeBufPtrs
(OUT) Points to an array of pointers that will receive the tree names.

Return values

0x0000
SUCCESSFUL

Negative Value
Negative values indicate errors. For errors returned by Directory Services, see ``Directory Services OS Errors'' (-001 to -255), ``Directory Services Client Library Errors'' (-301 to -399), or ``Directory Services Agent in the Server Errors'' (-601 to -699).

Notices

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).

Services

Connection (Directory Support)

NCP calls

None

References

NWDSScanForAvailableTrees(3nw)


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