Removes an existing partition from eDirectory by deleting its master replica.
#include <nwnet.h> or #include <nwdspart.h> N_EXTERN_LIBRARY (NWDSCCODE) NWDSRemovePartition ( NWDSContextHandle context, pnstr8 partitionRoot);
uses netwin32 Function NWDSRemovePartition (context : NWDSContextHandle; partitionRoot : pnstr8 ) : NWDSCCODE;
(IN) Specifies the NDS context for the request.
(IN) Points to the name of the root object of the partition to be removed.
These are common return values.
0x0000 0000 |
SUCCESSFUL |
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 eDirectory |
nonzero value |
Nonzero values indicate errors. See |
The partition must be completely empty (except for the root object) or the deletion will fail. In addition, no other replicas can exist.
Remove other replicas of the partition beforehand by calling NWDSRemoveReplica.
The partitionRoot parameter points to the name of the root object in the partition. Since NWDSRemovePartition must be performed on the partition’s master replica, it is assumed the operation will be performed on the server storing this replica.
Aliases are never dereferenced by NWDSRemovePartition. The setting of the NDS context flag associated with DCV_DEREF_ALIASES is not relevant and is ignored.