NWDSGetClassItemCount(3nw)


NWDSGetClassItemCount -- returns the number of object class definition items associated with a result buffer's current object class definition list in a result buffer

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsbuft.h> 
   

NWDSCCODE N_API NWDSGetClassItemCount (NWDSContextHandle context, pBuf_T buf, pnuint32 itemCount);

Description

The parameters are as follows:

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

buf
(IN) Points to the result buffer being read.

itemCount
(OUT) Points to the number of object-class definition items associated with the result buffer's current class-definition-item list.

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

buf points to Buf_T filled in by NWDSReadClassDef.

itemCount points to the number of object-class-definition items which are associated with the current class-definition-item list. There are five class-definition item lists; these lists are stored in the buffer in the following order:

  1. Super Class Names

  2. Containment Class Names

  3. Naming Attribute Names

  4. Mandatory Attribute Names

  5. Optional Attribute Names

The first two lists contain the names of classes. The remaining lists contain the names of attributes.

Before retrieving class items from a class-definition-item list, determine the number of items in the list by calling NWDSGetClassItemCount. Retrieve the items associates with the list by calling NWDSGetClassItem once for each item in the list. Then determine the number of items in the next list by calling NWDSGetClassItemCount, and retrieve the values for the list by calling NWDSGetClassItem, until you have retrieved all of the information from all lists.

For the complete steps for reading object-class-definition information, see NWDSReadClassDef(3nw)

Services

Directory

NCP calls

None

References

NWDSGetClassDef(3nw), NWDSGetClassItem(3nw), NWDSListContainableClasses(3nw), NWDSReadClassDef(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.