NWDSModifyDN(3nw)
NWDSModifyDN --
changes the distinguished name of an object or its alias in the Directory tree
Synopsis
#include <nwnet.h>
or
#include <nwdsdsa.h>
NWDSCCODE N_API NWDSModifyDN
(NWDSContextHandle context,
pnstr8 objectName,
pnstr8 newDN,
nbool8 deleteOldRDN);
Description
The parameters are as follows:
- context
-
(IN) Specifies the Directory context for the request.
- objectName
-
(IN) Points to the object's old name.
- newDN
-
(IN) Points to the object's new name.
- deleteOldRDN
-
(IN) Specifies whether to discard the old DN. If FALSE, the old DN is retained as an additional attribute value.
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 DN is the name of the object relative to its superior in the Directory
tree. The object being modified must be a leaf object, but it may be either an
object or its alias.
objectName points to the object whose DN is to be modified. Aliases
in the name will not be dereferenced.
newDN specifies the new DN of the object. It is a string identifying the name's attribute type and the attribute value in the form:
attribute type = attribute value
For example:
``CN = Mary''
If an attribute value in the new DN does not already exist in the object, it
is added. If it cannot be added, an error is returned.
If deleteOldDN is TRUE, all attribute values in the old DN
that are not in the new DN are deleted. If FALSE, old values remain
in the object (but not as a part of the
DN). The flag must be TRUE where a single-value attribute in the DN has its value changed by NWDSModifyDN.
If NWDSModifyDN removes the last attribute value of an attribute
while identifying a new attribute for the DN, the old attribute is deleted.
Aliases are never dereferenced by NWDSModifyDN. The context flag
associated with DCV_DEREF_ALIASES is not relevant to
NWDSModifyDN and is ignored.
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
NWDSModifyObject(3nw),
NWDSSetContext(3nw),
NWDSGetContext(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.