NWDSGetAttrCount(3nw)
NWDSGetAttrCount --
returns the number of attributes whose information is stored in a result buffer
Synopsis
#include <nwnet.h>
or
#include <nwdsbuft.h>
NWDSCCODE N_API NWDSGetAttrCount
(NWDSContextHandle context,
pBuf_T buf,
pnuint32 attrCount);
Description
The parameters are as follows:
- context
-
(IN) Specifies the Directory context for the request.
- buf
-
(IN) Points to Buf_T.
- attrCount
-
(OUT) Points to the number of attributes 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
NWDSGetAttrCount should be the first ``Get'' operation performed following a Read operation (such as NWDSRead, NWDSReadAttrDef, or
NWDSSearch).
After the attribute count has been determined, the attribute names can be retrieved from the buffer by calling NWDSGetAttrName or NWDSGetAttrDef. Attribute
values are retrieved using a combination of calls to NWDSComputeAttrValSize and NWDSGetAttrVal.
buf points to a Buf_T filled in by a previous call to a Directory Services function, such as NWDSRead.
Services
Directory
NCP calls
None
References
NWDSGetAttrDef(3nw),
NWDSGetAttrName(3nw),
NWDSRead(3nw),
NWDSReadAttrDef(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.