NWDSModifyClassDef(3nw)


NWDSModifyClassDef -- modifies an existing object-class definition

Synopsis

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

NWDSCCODE N_API NWDSModifyClassDef (NWDSContextHandle context, pnstr8 className, pBuf_T optionalAttrs);

Description

The parameters are as follows:

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

className
(IN) Points to the object class name whose definition is to be modified.

optionalAttrs
(IN) Points to a request buffer containing the names of attributes to be added to the object-class definition's Optional Attribute Names 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).

0x8996
SERVER_OUT_OF_MEMORY

0x89E2
TOO_FEW_FRAGMENTS

0x89E3
TOO_MANY_FRAGMENTS

0x89E4
PROTOCOL_VIOLATION

0x89E5
SIZE_LIMIT_EXCEEDED

0x89FD
UNKNOWN_REQUEST

0x89FD
INVALID_PACKET_LENGTH

0x89FE
BAD_PACKET

0x89FF
Failure not related to Directory Services

Notices

The only modifications clients can make to existing object-class definitions is the addition of optional attributes. No other characteristic of the object-class definition can be changed.

className identifies the object class to which optional attributes will be added.

optionalAttrs points to a request buffer containing a list of attribute names to be added to the Optional Attribute Names list of the object-class' definition.

Optional attributes can be added to an object-class definition by using the following steps:

  1. Allocate a request buffer by calling NWDSAllocBuf.

  2. Initialize the request buffer for a DS_MODIFY_CLASS_DEF operation by calling NWDSInitBuf.

  3. For each optional attribute to be added to the class definition, store the attribute's name in the request buffer by calling NWDSPutAttrName.

  4. Modify the object-class definition by calling NWDSModifyClassDef.

  5. Free the request buffer by calling NWDSFreeBuf.

Services

Directory

NCP calls

0x2222 23 17
Get File Server Information

0x2222 23 22
Get Station's Logged Info (old)

0x2222 23 28
Get Station's Logged Info

0x2222 104 01
Ping for NDS NCP

0x2222 104 02
Send NDS Fragmented Request/Reply

References

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