NWDSPutClassItem(3nw)


NWDSPutClassItem -- stores a class name or attribute name in an request buffer to be used by a Directory Services Schema function

Synopsis

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

NWDSCCODE N_API NWDSPutClassItem (NWDSContextHandle context, pBuf_T buf, pnstr8 itemName);

Description

The parameters are as follows:

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

buf
(IN) Points to the request buffer where the item will be stored.

itemName
(IN) Points to the class name or attribute name to be stored in the request 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

Class items are added to one of five class-definition item lists. The first two lists contain the names of classes; the remaining lists contain the names of attributes.

These class-definition item lists must be stored in the request 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

NWDSPutClassItem is used in conjunction with NWDSBeginClassItem to add items into the list. NWDSBeginClassItem is called to move to the next class-definition item list.

The first time NWDSBeginClassItem is called, items added with NWDSPutClassItem will be placed in the Super Class Names list.

The second time NWDSBeginClassItem is called, items added with NWDSPutClassItem will be placed in the Containment Class Names list.

Items are added to the other lists with subsequent calls to NWDSBeginClassItem and NWDSPutClassItem.

NWDSPutClassItem adds one item each time it is called. To store multiple items in a list, call NWDSPutClassItem for each item.

See NWDSDefineClass(3nw) for the complete steps to fill out a buffer to be used for defining a new class.

Services

Directory

NCP calls

None

References

NWDSReadClassDef(3nw), NWDSPutClassName(3nw), NWDSPutSyntaxName(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.