NWDSMutateObject

Mutates the specified entry from its current object class to the specified class.

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

  #include <nwnet.h> 
  or 
  #include <nwdsdsa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE) NWDSMutateObject  ( 
     NWDSContextHandle   context, 
     pnstr8              objectName,
     pnstr8              newObjectClass,
     nuint32             flags);

Parameters

context: (IN) Specifies the NDS context for the request or NULL for the preferred tree.
objectName: (IN) Points to the name of the object whose class is being changed.
newObjectClass: (IN) Points to the object class name.
flags: (IN) Specifies whether the default ACL template of the new object class should be applied to the object. The DSM_APPLY_ACL_TEMPLATES flag indicates that the default ACL template of the new class should be applied to the object.

Return Values

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

Remarks

To mutate an object from one class definition to another, the two definitions need to have matching mandatory attributes and schema rules. For example, a User object can be mutated to an Organizational Person object because both definitions are effective classes and share the same mandatory attributes, naming attributes, and containment rules. However, the User class definition has many more optional attributes defined than the Organizational Person class. If the object you are mutating has values in some of these attributes, the information will be lost.

If an auxiliary class has been added to the object, the auxiliary class attributes and their values will mutate to the new object.

NCP Calls