Поделиться через

CWbemProviderGlue::GetInstancesByQuery (wbemglue.h)

  • Статья

[Класс CWbemProviderGlue является частью платформы поставщика WMI, которая теперь рассматривается в окончательном состоянии, и никакие дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]

Метод GetInstancesByQuery извлекает список экземпляров, соответствующих конкретному запросу.

Синтаксис

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

Параметры

query

Выполняемый запрос.

pList

Связанный список экземпляров, соответствующих запросу, указанному в запросе.

pMethodContext

Указатель на текущий контекст. Для предотвращения взаимоблокировок необходимо предоставить контекст. Используйте контекст, переданный поставщику методом Provider::EnumerateInstances или Provider::ExecQuery, или получите его из экземпляра с помощью CInstance::GetMethodContext. Этот параметр не должен иметь значение NULL.

pszNamespace

Указатель на пространство имен, содержащее экземпляры . Если значение РАВНО NULL, используется пространство имен по умолчанию root\cimv2.

Возвращаемое значение

Метод возвращает WBEM_S_NO_ERROR , если операция прошла успешно, WBEM_E_FAILED , если операция завершилась сбоем, или любой другой код ошибки HRESULT .

Комментарии

Метод GetInstancesByQuery позволяет поставщикам платформы получать доступ к данным от других поставщиков без вызова API WMI. Поставщики платформы передают запрос в GetInstancesByQuery, который возвращает соответствующие экземпляры.

Для повышения производительности при вызове этой функции укажите только необходимые свойства (например, укажите " ИМЯ SELECT" вместо "SELECT *").

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wbemglue.h (включая FwCommon.h)
Библиотека FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll