NWDSBeginClassItem

Begins a class item definition (which is a part of an object class definition) in a request buffer to be used by a 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)  NWDSBeginClassItem  ( 
     NWDSContextHandle   context,  
     pBuf_T              buf);

Pascal

  uses netwin32 
   
  Function NWDSBeginClassItem 
    (context : NWDSContextHandle; 
     buf : pBuf_T 
  ) : NWDSCCODE

Parameters

context: (IN) Specifies the NDS context for the request.
buf: (IN) Points to the request buffer being prepared.

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

The buf parameter points to a Buf_T, which is allocated by NWDSAllocBuf and initialized by NWDSInitBuf for the DSV_DEFINE_CLASS operation.

NWDSBeginClassItem is used in conjunction with sName and NWDSPutAttrName to prepare a request buffer for NWDSDefineClass to use in creating a new object-class definition. This request buffer must contain a sequence of five sets of class definition item lists. The lists must occur in the following order:

Super Class Names
Containment Class Names
Naming Attribute Names
Mandatory Attribute Names
Optional Attribute Names

If a particular definition item list is empty, NWDSBeginClassItem must still be called for that list. For example, if the class definition has no mandatory attributes, you must call NWDSBeginClassItem to move to the Mandatory Attribute Names list and then immediately call NWDSBeginClassItem again to move to the Optional Attribute Names list.

The complete steps for creating a new object class definition are found in the reference for NWDSDefineClass.

NCP Calls

None