共用方式為


IVdsVolume2::GetProperties2 方法 (vds.h)

[從 Windows 8 和 Windows Server 2012 開始, 虛擬磁碟服務 COM 介面被 Windows 儲存管理 API 取代。]

回傳當前體積的屬性資訊。 此方法與 IVdsVolume::GetProperties 方法相同,不同之處在於回傳的是 VDS_VOLUME_PROP2 結構而非 VDS_VOLUME_PROP 結構。

語法

HRESULT GetProperties2(
  [out] VDS_VOLUME_PROP2 *pVolumeProperties
);

參數

[out] pVolumeProperties

呼叫者分配並傳遞的 VDS_VOLUME_PROP2 結構地址。 VDS 為 pwszName 成員字串分配記憶體。 呼叫者必須使用 CoTaskMemFree 函式來釋放字串。

返回值

此方法可回傳標準 HRESULT 值,如 E_INVALIDARG 或 E_OUTOFMEMORY,以及 VDS 專屬的回傳值。 它也能利用HRESULT_FROM_WIN32巨集回傳轉換後的系統錯誤碼。 錯誤可能來自 VDS 本身,或來自所使用的底層 VDS 提供者 。 可能的回傳值包括以下幾項。

傳回碼/值 Description
S_OK
方法已順利完成。
VDS_S_PROPERTIES_INCOMPLETE
0x00042715L
部分財產成功被尋回,但並非全部。 請注意,無法取得所有屬性的原因有很多,包括移除裝置。

備註

此方法可取得該卷的唯一磁碟區識別碼。 包含該識別碼的結構是 VDS_VOLUME_PROP2,而非 VDS_VOLUME_PROP

請注意,唯一磁碟區識別碼與磁碟區 GUID 路徑不同。 要找到卷的卷軸 GUID 路徑,請使用 IVdsVolumeMF3::QueryVolumeGuidPathnames 方法。

需求

Requirement 價值觀
最低支援的用戶端 Windows 7 [僅限桌面應用程式]
支援的最低伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平臺 窗戶
Header VDS.H
Library Uuid.lib

另請參閱

IVds第二卷