3.4.5.2.29.2 IVdsDiskPartitionMF::GetPartitionFileSystemTypeName (Opnum 4)

  • Article

The GetPartitionFileSystemTypeName method retrieves the name of the file system on a disk partition at a specified byte offset. This method is only supported on OEM, ESP, recovery, and unknown partitions.

 HRESULT GetPartitionFileSystemTypeName(
   [in] ULONGLONG ullOffset,
   [out, string] WCHAR** ppwszFileSystemTypeName
 );

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

ppwszFileSystemTypeName: A pointer that, if the operation is successfully completed, receives a null-terminated Unicode string with the file system name.

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.

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

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

  • Verify that ppwszFileSystemTypeName is not NULL.

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

The server MUST point ppwszFileSystemTypeName to a string containing the file system name on the partition at the byte offset from the beginning of the disk that ullOffset specifies and then return an HRESULT indicating failure or success.