3.2.4.4.3.16 IVolumeClient3::FTReplaceMirrorPartition (Opnum 19)

  • Article

The FTReplaceMirrorPartition method repairs an FT mirror set by replacing the failed member of the set with another partition. This method operates on an FT volume on basic disks (rather than dynamic disks). The partition MUST have the same type as the original, it MUST be MBR, and it MUST be at least as big as the original partition.<200>

 HRESULT FTReplaceMirrorPartition(
   [in] LdmObjectId volumeId,
   [in] hyper volumeLastKnownState,
   [in] LdmObjectId oldMemberId,
   [in] hyper oldMemberLastKnownState,
   [in] LdmObjectId newRegionId,
   [in] hyper newRegionLastKnownState,
   [in] DWORD flags,
   [out] TASK_INFO* tinfo
 );

volumeId: Specifies the OID of the FT mirror set to modify.

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

oldMemberId: This parameter MUST be set to 0 by the client and ignored by the server.

oldMemberLastKnownState: This parameter MUST be set to 0 by the client and ignored by the server.

newRegionId: Specifies the OID of the replacement partition. The partition MUST have the same type as the original, it MUST be MBR, and it MUST be at least as big as the original partition.

newRegionLastKnownState: Last known modification sequence number of the replacement partition.

flags: Bitmap of flags for the replacement operation. The value of this field is a logical 'OR' of zero or more of the following applicable flags.

Value

Meaning

FTREPLACE_FORCE

0x00000001

Do not fail the operation if the replacement partition has been changed since newRegionLastKnownState.

FTREPLACE_DELETE_ON_FAIL

0x00000002

Delete the replacement partition if the operation fails.

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]; see also section 2.2.1 for HRESULT values predefined by the Disk Management Remote Protocol).

When the server receives an IVolumeClient3::FTReplaceMirrorPartition message, it MUST process that message, as specified in IVolumeClient::FTReplaceMirrorPartition (section 3.2.4.4.1.16).