NWDSPutClassName(3nw)


NWDSPutClassName -- stores a class name in an request buffer to be used by a Directory Services function

Synopsis

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

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

Description

The parameters are as follows:

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

buf
(IN) Points to the request buffer being prepared.

itemName
(IN) Points to the class 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

NWDSPutClassName is a macro that calls NWDSPutClassItem. The purpose of NWDSPutClassName is to make source code more descriptive by having the function name identify what type of class item is being stored in the request buffer.

Class items are added to one of five class-definition item lists. These class-definition item 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 object class names; the remaining lists contain attribute names. NWDSPutClassName is used to place class names into the Super Class Names and the Containment Class Names lists. NWDSPutClassItem is used for the other lists.

Services

Directory

NCP calls

None

References

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