(vds.h) IVdsServiceHba：：QueryHbaPorts 方法

[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。

會傳回 IEnumVdsObject 列舉物件，其中包含本機系統上 VDS 已知的 HBA 埠清單。

語法

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

[out] ppEnum

IEnumVdsObject 介面指標的位址，可用來將 HBA 埠列舉為 HBA 埠物件。如需詳細資訊，請參閱使用列舉物件。呼叫端呼叫 IUnknown：：Release 方法時，必須釋放介面和每個 HBA 埠物件。

這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。它也可以使用 HRESULT_FROM_WIN32 宏傳回已轉換的系統錯誤碼。錯誤可能源自 VDS 本身，或來自正在使用的基礎 VDS 提供者。可能的傳回值包括下列專案。

傳回碼/值	描述
S_OK	已成功傳回 HBA 埠的列舉。如果本機系統沒有 HBA 埠，則列舉是空的。
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS 無法初始化。如果應用程式在 VDS 服務完成初始化之前呼叫這個方法，則會封鎖方法，直到初始化完成為止。如果初始化失敗，則會傳回此錯誤。