Share via

3.4.5.2.34.1 IVdsVolumeMF::GetFileSystemProperties (Opnum 3)

  • Article

The GetFileSystemProperties method returns property details about the file system on the current volume.

 HRESULT GetFileSystemProperties(
   [out] VDS_FILE_SYSTEM_PROP* pFileSystemProp
 );

pFileSystemProp: A pointer to a VDS_FILE_SYSTEM_PROP structure that, if the operation is successfully completed, receives the properties of the file system on the volume.

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.

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

  • Verify that pFileSystemProp is not NULL.

The server MUST populate the VDS_FILE_SYSTEM_PROP structure (as specified in section 2.2.1.3.17) that pFileSystemProp references by using the properties of the file system on the volume. The server MUST then return an HRESULT indicating failure or success.

If the volume is associated with a removable device and there is no media present, then this method MUST return VDS_E_NO_MEDIA.

If the volume is in the OFFLINE state, then this method SHOULD<126> return VDS_E_VOLUME_NOT_ONLINE.

If the user level access granted to the thread that makes this method call does not have sufficient privileges, then this method MUST convert the Win32 error ERROR_ACCESS_DENIED to an HRESULT and return the result to the calling application.