[從 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 |
|---|---|
|
方法已順利完成。 |
|
部分財產成功被尋回,但並非全部。 請注意,無法取得所有屬性的原因有很多,包括移除裝置。 |
備註
此方法可取得該卷的唯一磁碟區識別碼。 包含該識別碼的結構是 VDS_VOLUME_PROP2,而非 VDS_VOLUME_PROP。
請注意,唯一磁碟區識別碼與磁碟區 GUID 路徑不同。 要找到卷的卷軸 GUID 路徑,請使用 IVdsVolumeMF3::QueryVolumeGuidPathnames 方法。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限桌面應用程式] |
| 支援的最低伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | VDS.H |
| Library | Uuid.lib |