NWDSSyncReplicaToServer(3nw)


NWDSSyncReplicaToServer -- requests a replica to synchronize with a specific server

Synopsis

   #include <nwdsmisc.h> 
   

NWDSCCODE N_API NWDSSyncReplicaToServer (NWDSContextHandle context, NWCONN_HANDLE connHandle, pnstr8 partitionRootName, pnstr8 destServerName, nuint32 actionFlags, nuint32 delaySeconds);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context for the request.

serverName
(IN) Specifies the server that contains the replica being synchronized.

partitionRootName
(IN) Specifies the name of the partition whose replica is being synchronized.

destServerName
(IN) Specifies the server to which the replica should synchronize to.

actionFlags
(IN) Specifies the synchronization action to be taken.

delaySeconds
(IN) Specifies the number of seconds to delay before beginning the synchronization.

Return values

0x0000
SUCCESS

Non-zero Value
Error

Notices

NWDSSyncReplicaToServer requests that a replica initiate synchronization with the destination server identified by destServerName. The actionFlags parameter has the following definition:

SF_DO_IMMEDIATE
Perform the action immediately.

SF_TRANSITION
If the replica is in one of the states ``New'', ``Dying'', or ``Transition On'', the request is ignored and SUCCESS is returned.

NWDSSyncReplicaToServer has the side effect of blocking until the synchronization process has completed. The return code indicates the status of the replica by returning SUCCESS or a negative error code, which indicates a problem with synchronization of this replica.

Services

Directory

NCP calls

None

References

NWDSSyncPartition(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.