3.2.4.1.17 RdcFileDataTransferKeepAlive (Opnum 17)

  • Article

The RdcFileDataTransferKeepAlive method is used to keep the server context alive.

 DWORD RdcFileDataTransferKeepAlive(
   [in] PFRS_SERVER_CONTEXT serverContext
 );

serverContext: The context handle that represents the requested file replication operation that was retrieved by a previously successful call to the InitializeFileTransferAsync method.

Return Values: This method MUST return 0 on success or a nonzero error code on failure. For protocol purposes all nonzero values MUST be treated as equivalent failures unless otherwise specified.

Return value/code

Description

0x00000000

ERROR_SUCCESS

The method completed successfully.

0x00000057

ERROR_INVALID_PARAMETER

The context is invalid.

0x00002344

FRS_ERROR_CONTENTSET_NOT_FOUND

The content set was not found.

0x0000234B

FRS_ERROR_RDC_GENERIC

Unknown error in RDC.

0x0000234B

FRS_ERROR_IN_BACKUP_RESTORE

Paused for backup or restore.

The server MUST validate the request by performing the following checks:

  •  If the serverContext is being used in another request and the server is still processing that request, the server MUST fail the call with ERROR_INVALID_PARAMETER.

  • If serverContext is not available, the server MUST fail the call with FRS_ERROR_CONTENTSET_NOT_FOUND.

  • If the server is not currently participating in replication of the replicated folder that is associated with the specified serverContext, the server MUST fail the call with FRS_ERROR_CONTENTSET_NOT_FOUND.

  • If the server is processing a VSS backup or restore operation, the server MUST fail the call with FRS_ERROR_IN_BACKUP_RESTORE.

Actions Triggered: The server MUST reset and start the time-outs on the open file handles timer. The server MUST return ERROR_SUCCESS to the client.