Changes the replica type of a given replica on a given server.
#include <nwnet.h>
or
#include <nwdspart.h>
N_EXTERN_LIBRARY (NWDSCCODE) NWDSChangeReplicaType (
NWDSContextHandle context,
pnstr8 replicaName,
pnstr8 server,
nuint32 newReplicaType);
uses netwin32
Function NWDSChangeReplicaType
(context : NWDSContextHandle;
replicaName : pnstr8;
server : pnstr8;
newReplicaType : nuint32
) : NWDSCCODE;
(IN) Specifies the NDS context for the request.
(IN) Points to the root object name of the eDirectory partition whose replica type will be changed.
(IN) Points to the name of the server on which the replica resides.
(IN) Specifies the replica type the given replica is to be changed to (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 |
A change in type from read-only to secondary or secondary to read-only affects only the given replica. A change to RT_MASTER results in the current master being changed to a secondary replica.
The replica type of the master may not be changed directly by calling NWDSChangeReplicaType. The replica type of the master replica can change only as a side effect of NWDSChangeReplicaType changing another replica’s type to RT_MASTER.