Adds a replica of an existing eDirectory partition to a server.
#include <nwnet.h> or #include <nwdspart.h> N_EXTERN_LIBRARY (NWDSCCODE) NWDSAddReplica ( NWDSContextHandle context, pnstr8 server, pnstr8 partitionRoot ; nuint32 replicaType);
uses netwin32 Function NWDSAddReplica (context : NWDSContextHandle; server : pnstr8; partitionRoot : pnstr8; replicaType : nuint32 ) : NWDSCCODE;
(IN) Specifies the NDS context for the request.
(IN) Points to the name of the server where the replica is to be stored.
(IN) Points to the name of the root object of the eDirectory partition to be replicated.
(IN) Specifies the type of the new replica (see Section 5.23, Replica Types).
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 created beforehand by calling NWDSSplitPartition.
NOTE:You cannot create a master replica type (RT_MASTER) with NWDSAddReplica. To make a new replica the mater replica, use NWDSChangeReplicaType.
Aliases are never dereferenced by NWDSAddReplica. The setting of the NDS context flag associated with DCV_DEREF_ALIASES is not relevant and is ignored.