Share via

3.2.4.4.3.17 IVolumeClient3::FTReplaceParityStripePartition (Opnum 20)

  • Article

The FTReplaceParityStripePartition method repairs an FT RAID-5 set by replacing the failed member of the set with another 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.

 HRESULT FTReplaceParityStripePartition(
   [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 RAID-5 set to modify.

volumeLastKnownState: Last known modification sequence number of the FT RAID-5 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.

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::FTReplaceParityStripePartition message, it MUST process that message as specified in IVolumeClient::FTReplaceParityStripePartition (section 3.2.4.4.1.17).