IVolumeClient::FTResyncMirror (Opnum 17)

The FTResyncMirror method restores the redundancy of an FT mirror set on basic disks by resynchronizing the members of the mirror. This is a synchronous task.<59>

 HRESULT FTResyncMirror(
   [in] LdmObjectId volumeId,
   [in] hyper volumeLastKnownState,
   [out] TASK_INFO* tinfo

volumeId: Specifies the OID of the FT mirror set that is being resynchronized.

volumeLastKnownState: Last known modification sequence number of the FT mirror set.

tinfo: Pointer to a TASK_INFO structure that the client can use to track the request's progress.

Return Values: The method MUST return 0 or a nonerror HRESULT on success, or an implementation-specific nonzero error code on failure (as specified in [MS-ERREF] section 2.1; see also section 2.2.1 for HRESULT values predefined by the Disk Management Remote Protocol).

Upon receiving this message, the server MUST validate parameters:

  • Verify that the FT volume specified by volumeId is in the list of storage objects, and check if volumeLastKnownState matches the LastKnownState field of the object. Verify that the FT volume is an FT mirror set.

  • Verify that tinfo is not NULL.

If parameter validation fails, the server MUST fail the operation immediately, returning an appropriate error as its response to the client.

Otherwise, the server MUST process the message as follows:

  1. Start the resynchronization of the members of the FT volume specified by volumeId.

  2. Wait for the resynchronization start to either succeed or fail.

  3. Fill in the tinfo output parameter.

    TASK_INFO member

    Required for this operation




    Not required.


    Not required.<60>


    Not required.<61>


    Required for any task that returns REQ_IN_PROGRESS.




    Required if PercentageComplete is being used.




    Not required.<62>

  4. Return a response to the client that contains tinfo and the status of the operation.