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.