Share via

3.2.4.4.3.13 IVolumeClient3::FTBreakMirror (Opnum 16)

  • Article

The FTBreakMirror method breaks a specified FT mirror set on basic disks into two independent partitions.<197>

 HRESULT FTBreakMirror(
   [in] LdmObjectId volumeId,
   [in] hyper volumeLastKnownState,
   [in] boolean bForce,
   [out] TASK_INFO* tinfo
 );

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

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

bForce: Boolean value that indicates whether to force removal of the drive letter from the FT mirror set.

Value

Meaning

FALSE

0

The method fails if an error occurs while the drive letter is being removed from the FT mirror set.

TRUE

1

Removal of the drive letter from the FT mirror set is forced.

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