3.2.4.4.3.4 IVolumeClient3::CreatePartitionAssignAndFormat (Opnum 6)

  • Article

The CreatePartitionAssignAndFormat method creates a partition, formats it as a file system, and assigns it a drive letter.

 HRESULT CreatePartitionAssignAndFormat(
   [in] REGION_SPEC partitionSpec,
   [in] wchar_t letter,
   [in] hyper letterLastKnownState,
   [in] FILE_SYSTEM_INFO fsSpec,
   [in] boolean quickFormat,
   [out] TASK_INFO* tinfo
 );

partitionSpec: A REGION_SPEC structure that defines the type and length of the partition to create.

letter: Drive letter to assign to the new volume.

letterLastKnownState: Drive letter's last known modification sequence number. This value is returned from a call to EnumDriveLetters.

fsSpec: A FILE_SYSTEM_INFO structure that defines the file system to create.

quickFormat: Boolean value that determines whether the server will fully format or quickly format the file system.

Value

Meaning

FALSE

0

File system will be fully formatted. Full format requires verifying the accessibility of all sectors on the volume.

TRUE

1

File system will be quickly formatted.

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