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.