Share via

3.4.5.2.29.3 IVdsDiskPartitionMF::QueryPartitionFileSystemFormatSupport (Opnum 5)

  • Article

The QueryPartitionFileSystemFormatSupport method retrieves the properties of the file systems that support formatting a disk partition at a specified byte offset. This method is only supported on OEM, ESP, recovery, and unknown partitions.

Note This method is not valid on CD/DVD or super floppy devices. These devices do not support partition tables.

 HRESULT QueryPartitionFileSystemFormatSupport(
   [in] ULONGLONG ullOffset,
   [out, size_is(,*plNumberOfFileSystems)] 
     VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP** ppFileSystemSupportProps,
   [out] long* plNumberOfFileSystems
 );

ullOffset: The byte offset of the partition from the beginning of the disk. This MUST be the offset at the start of a partition.

ppFileSystemSupportProps: A pointer to an array of VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP structures which, if the operation completes successfully, receives an array of properties of each supported file system.

plNumberOfFileSystems: A pointer to a variable which, if the operation completes successfully, receives the total number of elements returned in ppFileSystemSupportProps.

Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code to indicate failure. For the HRESULT values predefined by the Virtual Disk Service Remote Protocol, see section 2.2.3.<107>

ERROR_SUCCESS (0x00000000)

When the server receives this message, it MUST validate the following parameters:

  • Verify that ppFileSystemSupportProps is not NULL.

  • Verify that plNumberOfFileSystems is not NULL.

  • Verify that the partition at offset ullOffset is an OEM, ESP, recovery, or unknown partition.

The server MUST point ppFileSystemSupportProps to an array of VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP structures containing information about each file system that supports formatting a partition  at the byte offset from the beginning of the disk that ullOffset specifies. The server MUST then point plNumberOfFileSystems to the size of the array and then return an HRESULT indicating failure or success.