Метод CWbemProviderGlue::GetAllInstances (wbemglue.h)

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

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

Синтаксис

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

Параметры

pszClassName

Имя класса, для которого должен быть возвращен список экземпляров.

pList

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

pszNamespace

Пространство имен поставщика, указанного с помощью pszClassName. Этот параметр может иметь значение NULL , чтобы указать пространство имен по умолчанию— Root\CIMv2.

pMethodContext

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

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

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

Комментарии

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

Этот метод семантически эквивалентен запросу SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName.

Требования