共用方式為


IVdsDisk::GetProperties 方法(vds.h)

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

回傳磁碟的屬性資訊。

語法

HRESULT GetProperties(
  [out] VDS_DISK_PROP *pDiskProperties
);

參數

[out] pDiskProperties

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

返回值

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

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

需求

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

另請參閱

IVds磁碟

VDS_DISK_PROP