This section provides procedures for reading information about partitions and replicas and for managing them (adding, moving, joining, splitting, and deleting).
To add a replica of an existing partition to a server, complete the following step.
Call NWDSAddReplica with the name of the partition's root object.
This function adds replicas only of type secondary or read-only. You identify the partition to be replicated by supplying the name of the partition’s root object.
To change a replica’s type, complete the following step.
Call NWDSChangeReplicaType.
You identify the replica by passing in the name of the server containing the replica and the name of the partition’s root object. If you change a replica’s type to master, the current master replica will be changed to a secondary replica.
To join a subordinate partition to its parent, complete the following step.
Call NWDSJoinPartitions.
You can perform this operation only on master replicas residing on the same server. You can join two partitions if no secondary or read-only replicas of either partition exist. The two partitions joined must be a subordinate partition and its parent.
To obtain information about the partitions stored on a specified server, complete the following steps.
Allocate a result buffer to receive the results by calling NWDSAllocBuf. (The buffer does not need to be initialized since it is a result buffer.)
Set the iteration handle to NO_MORE_ITERATIONS.
Obtain the partition information by calling NWDSListPartitions.
Determine the number of partitions whose information is stored in the result buffer by calling NWDSGetServerName.
For each partition whose information is stored in the buffer, retrieve the partition name and type by calling NWDSGetPartitionInfo.
If the iteration handle is set to NO_MORE_ITERATIONS, go to Step 7; otherwise, loop to Step 3.
Free the buffer when it is no longer needed by calling NWDSFreeBuf.
If you decide to stop retrieving partition information before iterationHandle is set to NO_MORE_ITERATIONS, call NWDSCloseIteration to free memory and state information associated with the partition listing operation.
To delete a partition, complete the following step.
Call NWDSRemovePartition.
You can remove a partition only if there are no secondary or read-only replicas of the partition. The partition must also be empty, containing no other objects except the root container object.
To delete a replica of a partition, complete the following step.
Call NWDSRemoveReplica.
You identify the replica by supplying the name of the server and the name of the partition’s root object. This function can remove only secondary and read-only replicas.
NOTE:NWDSJoinPartitions removes the master replica of the subordinate partition.
To divide a partition at a specified object, complete the following step.
Call NWDSSplitPartition.
The specified object becomes the root object of the subordinate partition. Split operations are always performed on the master replica.