IVdsDisk3：：GetProperties2 方法 （vds.h）

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

回傳磁碟的屬性資訊。 此方法與 IVdsDisk：：GetProperties 方法相同，不同之處在於回傳的是 VDS_DISK_PROP2 結構而非 VDS_DISK_PROP 結構。

語法

HRESULT GetProperties2(
  [out] VDS_DISK_PROP2 *pDiskProperties
);

參數

[out] pDiskProperties

呼叫者分配並傳遞的 VDS_DISK_PROP2 結構地址。 VDS 為 pwszDiskAddress、 pwszName、 pwszFriendlyName、 pwszAdaptorName、 pwszDevicePath 及 pwszLocationPath 成員字串分配記憶體。 呼叫者必須使用 CoTaskMemFree 函式來釋放字串。

返回值

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

備註

在 pDiskProperties 參數回傳的 VDS_DISK_PROP2 結構中，pwszDiskAddress 成員為可選，若無可用值則可為 NULL。 呼叫此方法的使用者必須檢查該成員是否為 NULL。

對於 Hyper-V，pwszLocationPath 成員為 NULL，因為虛擬控制器不會回傳位置路徑。

需求

另請參閱

IVds磁碟3

VDS_DISK_PROP2