NWDSSyncReplicaToServer

Requests a replica to synchronize with a specific server.

NetWare Server:4.x, 5.x, 6.x

Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP

Library:Cross-Platform NDS (NET*.*)

Service:NDS

Syntax

C

  #include <nwnet.h> 
  or
  #include <nwdsmisc.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSSyncReplicaToServer  ( 
     NWDSContextHandle   context,  
     pnstr8              serverName,  
     pnstr8              partitionRootName,  
     pnstr8              destServerName,  
     nuint32             actionFlags,  
     nuint32             delaySeconds);

Pascal

  uses netwin32 
   
  Function NWDSSyncReplicaToServer 
    (context : NWDSContextHandle; 
     serverName : pnstr8; 
     partitionRootName : pnstr8; 
     destServerName : pnstr8; 
     actionFlags : nuint32; 
     delaySeconds : nuint32 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
serverName: (IN) Specifies the server that contains the replica to be synchronized.
partitionRootName: (IN) Points to the name of the partition whose replica is to be synchronized.
destServerName: (IN) Points to the server to which the replica should synchronize.
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 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

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. Ignored unless SF_DO_IMMEDIATE is also set
SF_SEND_ALL: Synchronize all objects, as opposed to only those that have changed.
SF_SEND_SINGLE_ENTRY: Synchronize only the subject object. Ignored if SF_SEND_ALL is set.

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.

NCP Calls

None