CWbemProviderGlue：：GetInstancesByQuery (wbemglue.h)

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

GetInstancesByQuery 方法會擷取符合特定查詢的實例清單。

語法

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

參數

query

要執行的查詢。

pList

符合 Query 所指定查詢的實例連結清單。

pMethodContext

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

pszNamespace

包含實例之命名空間的指標。 如果 為 NULL，則會使用預設命名空間 root\cimv2。

傳回值

如果作業成功，方法會傳回 WBEM_S_NO_ERROR ，如果作業失敗 ，WBEM_E_FAILED 或任何其他 HRESULT 錯誤碼。

備註

GetInstancesByQuery 方法可讓架構提供者存取其他提供者的數據，而不需要進行 WMI API 呼叫。 架構提供者會將查詢傳遞至 GetInstancesByQuery，這會傳回適當的實例。

基於效能考慮，呼叫此函式時，請只指定您需要的屬性 (，請指定 “SELECT name”，而不是 “SELECT *”) 。

規格需求