IVdsService：：QueryProviders 方法 (vds.h)

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

傳回列舉物件，其中包含 VDS 已知的硬體和軟體提供者清單。

語法

HRESULT QueryProviders(
  [in]  DWORD          masks,
  [out] IEnumVdsObject **ppEnum
);

[in] masks

由 VDS_QUERY_PROVIDER_FLAG 列舉的提供者遮罩。呼叫端可以指定軟體提供者遮罩、硬體提供者遮罩或兩者。

[out] ppEnum

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

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

傳回碼/值	描述
S_OK	成功傳回列舉。
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS 無法初始化。如果應用程式在服務完成初始化之前呼叫此方法，則會封鎖方法，直到初始化完成為止。如果初始化失敗，則會傳回此錯誤。

若要判斷硬體提供者的提供者類型，請為每個提供者物件呼叫 IVdsHwProviderType2：：GetProviderType2 方法或 IVdsHwProviderType：：GetProviderType 方法。