NWDSPutClassItem

Stores a class name or attribute name in a request buffer to be used by an eDirectory schema function.

NetWare Server:4.x, 5.x, 6.x

Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP

Library:Cross-Platform NDS (NET*.*)

Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsbuft.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSPutClassItem  ( 
     NWDSContextHandle   context,  
     pBuf_T              buf,  
     pnstr8              itemName);

Pascal

  uses netwin32 
   
  Function NWDSPutClassItem 
    (context : NWDSContextHandle; 
     buf : pBuf_T; 
     itemName : pnstr8 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS 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 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

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:

Super Class Names
Containment Class Names
Naming Attribute Names
Mandatory Attribute Names
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 Creating a Class Definition for the complete steps to fill out a buffer to be used for defining a new class.

NCP Calls

None