Share via

3.2.4.4.3.6 IVolumeClient3::DeletePartition (Opnum 8)

  • Article

The DeletePartition method deletes a specified partition.

 HRESULT DeletePartition(
   [in] REGION_SPEC partitionSpec,
   [in] boolean force,
   [out] TASK_INFO* tinfo
 );

partitionSpec: A REGION_SPEC structure that specifies the type and length of the partition to delete.

force: Value that determines if deletion of the partition will be forced. If the force parameter is not set, the call will fail if the volume cannot be locked.

Value

Meaning

FALSE

0

Deletion will not be forced if the partition is in use.

TRUE

1

Deletion will be 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::DeletePartition message, it MUST process that message, as specified in IVolumeClient::DeletePartition (section 3.2.4.4.1.6).