NWDSGetObjectCount(3nw)
NWDSGetObjectCount --
returns the number of objects whose information is stored in a result buffer
Synopsis
#include <nwnet.h>
or
#include <nwdsbuft.h>
NWDSCCODE N_API NWDSGetObjectCount
(NWDSContextHandle context,
pBuf_T buf,
pnuint32 objectCount);
Description
The parameters are as follows:
- context
-
(IN) Specifies the Directory context for the request.
- buf
-
(IN) Points to the result buffer being read.
- objectCount
-
(OUT) Points to the number of objects whose information is stored in the result buffer.
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
NWDSGetObjectCount must be the first function used to read a result buffer containing information about objects, such as result buffers filled in by NWDSList,
NWDSRead, and NWDSSearch.
The full steps for retrieving object information from a result buffer are listed in the references for NWDSList, NWDSRead, and NWDSSearch.
Services
Directory
NCP calls
None
References
NWDSGetAttrName(3nw),
NWDSGetAttrVal(3nw),
NWDSGetObjectName(3nw),
NWDSList(3nw),
NWDSSearch(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.