NWDSMoveObject(3nw)


NWDSMoveObject -- moves a Directory object from one container to another and/or renames the object

Synopsis

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

NWDSCCODE N_API NWDSMoveObject (NWDSContextHandle context, pnstr8 objectName, pnstr8 destParentDN, pnstr8 destRDN);

Description

The parameters are as follows:

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

objectName
(IN) Points to the name of the object to be moved.

destParentDN
(IN) Points to the name of the object's new parent.

destRDN
(IN) Points to the object's new RDN.

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

NWDSMoveObject can move an object only if it is a leaf object (meaning it does not have any subordinate objects associated with it). However, it may be either an object or its alias.

The new RDN (such as ``Hector'') may be the same as the original object's RDN or it may be different.

If you are going to rename the object but not move it, you should call NWDSModifyRDN instead of NWDSMoveObject.

objectName identifies the object whose DN is to be modified. Aliases in the name will not be dereferenced. Aliases are never dereferenced by NWDSMoveObject. The setting of the context flag associated with DCV_DEREF_ALIASES is not relevant to NWDSMoveObject and is ignored.

destParentDN identifies the name of the parent object the moved object is to be directly subordinate to. The parent object must already exist in the Directory tree.

destRDN specifies the new RDN of the object being moved.

If Hector is represented in the Directory tree as

   CN=Hector.OU=Graphics.O=WimpleMakers 

and you want to move Hector to Marketing, for objectName pass in

   CN=Hector.OU=Graphics.O=WimpleMakers 

for destParentDN pass in

   OU=Marketing.O=WimpleMakers 

and for destRDN pass in

   CN=Hector 

On successful completion, Hector is moved to the new location in the Directory tree, and his complete Directory name becomes

   CN=Hector.OU=Marketing.O=WimpleMakers 

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 forNDS NCP

0x2222 104 02
Send NDS Fragmented Request/Reply

References

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