IVdsControllerPort：：QueryControllerPorts 方法（vds.h）

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

回傳一個 IEnumVdsObject 物件，列舉控制器的埠口。

語法

HRESULT QueryControllerPorts(
  [out] IEnumVdsObject **ppEnum
);

[out] ppEnum

IEnumVdsObject 介面指標的位址，可用來枚舉控制器埠作為控制器埠物件。更多資訊請參見「使用枚舉物件」。呼叫者必須在介面及控制器埠物件不再需要時，透過呼叫 IUnknown：：Release 方法來釋放。

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

傳回碼/值	Description
S_OK	控制器埠的列舉成功回傳。如果控制器沒有埠口，則列舉為空。
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	提供者的快取已經損壞。這表示供應商內部存在軟體或通訊問題，會快取連接裝置的資訊。呼叫者可以使用 IVdsHwProvider：：Reenumerate 方法，接著 IVdsHwProvider：：Refresh 方法來還原快取。
VDS_E_OBJECT_DELETED 0x8004240BL	控制器物件已不存在。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	控制器處於失敗狀態，無法執行所請求的操作。
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	另一項手術正在進行中。此操作必須完成前一操作才能繼續。
VDS_E_NOT_SUPPORTED 0x80042400L	此操作未由本服務提供者支援。

此頁面對您有幫助嗎？