CWbemProviderGlue：：GetAllInstances 方法 (wbemglue.h)

[ CWbemProviderGlue 類別是 WMI 提供者架構的一部分，它現在被視為最終狀態，而且不會針對影響這些連結庫的非安全性相關問題進一步開發、增強功能或更新。 MI API 應該用於所有新的開發。]

GetAllInstances 方法會擷取特定類別所傳回的實例清單。

語法

HRESULT GetAllInstances(
  LPCWSTR                          pszClassName,
  TRefPointerCollection<CInstance> *pList,
  LPCWSTR                          pszNamespace,
  MethodContext                    *pMethodContext
);

參數

pszClassName

應該傳回實例清單的類別名稱。

pList

pszClassName 所指定提供者所支持的實例連結清單。

pszNamespace

pszClassName 所指定之提供者的命名空間。 這個參數可以是 NULL ，表示預設命名空間，也就是 “Root\CIMv2”。

pMethodContext

目前內容的指標。 必須提供內容以防止死結。 使用 由 Provider：：EnumerateInstances 或 Provider：：ExecQuery 傳遞至提供者的內容，或使用 CInstance：：GetMethodContext 從實例取得它。 此參數不得為 NULL。

傳回值

如果作業成功，此方法會傳回WBEM_S_NO_ERROR，WBEM_E_OUT_OF_MEMORY作業因記憶體不足或任何其他 HRESULT 錯誤碼而失敗。

備註

GetAllInstances 方法可讓架構提供者從另一個提供者存取數據，而不需要進行 WMI API 呼叫。 架構提供者會將提供者的名稱傳遞至 GetAllInstances，這會傳回提供者支援的所有實例清單。

這個方法在語意上相當於查詢 SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName。

規格需求