[從 Windows 8 和 Windows Server 2012 開始, 虛擬磁碟服務 COM 介面被 Windows 儲存管理 API 取代。]
回傳子系統的屬性。 此方法與 IVdsSubSystem::GetProperties 方法相同,不同之處在於回傳的是 VDS_SUB_SYSTEM_PROP2 結構而非 VDS_SUB_SYSTEM_PROP 結構。
語法
HRESULT GetProperties2(
[out] VDS_SUB_SYSTEM_PROP2 *pSubSystemProp2
);
參數
[out] pSubSystemProp2
呼叫者分配並傳遞的 VDS_SUB_SYSTEM_PROP2 結構地址。 VDS 為 pwszFriendlyName 和 pwszIdentification 成員字串分配記憶體。 呼叫者必須使用 CoTaskMemFree 函式來釋放字串。
返回值
此方法可回傳標準 HRESULT 值,如 E_INVALIDARG 或 E_OUTOFMEMORY,以及 VDS 專屬的回傳值。 它也能利用HRESULT_FROM_WIN32巨集回傳轉換後的系統錯誤碼。 錯誤可能來自 VDS 本身,或來自所使用的底層 VDS 提供者 。 可能的回傳值包括以下幾項。
| 傳回碼/值 | Description |
|---|---|
|
部分財產成功被尋回,但並非全部。 請注意,無法取得所有屬性的原因有很多,包括移除裝置。 |
|
提供者內部存在軟體或通訊問題,會快取陣列資訊。 使用 IVdsHwProvider::Reenumerate 方法,接著 IVdsHwProvider::Refresh 方法來還原快取。 |
|
子系統物件已不存在。 |
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限桌面應用程式] |
| 支援的最低伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | VDS.H |
| Library | Uuid.lib |