Метод IWbemConfigureRefresher::AddEnum (wbemcli.h)

Статья
08/27/2023

Метод IWbemConfigureRefresher::AddEnum добавляет перечислитель в запрошенное средство обновления.

Синтаксис

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

Параметры

[in] pNamespace

Указатель IWbemServices обратно на управление Windows, который может обслуживать любой запрос, сделанный поставщиком. Если метод должен вызвать метод обратно в управление Windows во время его выполнения, поставщик должен вызвать AddRef с указателем pNamespace .

[in] wszClassName

Константная строка, заканчивающаяся нулевым значением, из 16-разрядных символов Юникода, содержащая имя перечисляемого класса.

[in] lFlags

Битовая маска флагов, которые изменяют поведение этого метода. Если для этого параметра задано значение WBEM_FLAG_USE_AMENDED_QUALIFIERS, возвращаемые экземпляры содержат локализованные квалификаторы, если они доступны.

[in] pContext

Как правило, значение NULL; В противном случае это указатель на объект IWbemContext , необходимый для одного или нескольких поставщиков динамических классов. Значения в объекте контекста должны быть указаны в документации конкретного поставщика. Дополнительные сведения об этом параметре см. в разделе Выполнение вызовов WMI.

[out] ppEnum

Указатель, содержащий ссылку на объект IWbemHiPerfEnum , который будет содержать перечисление . Клиент должен вызывать Release для этого указателя, если он больше не требуется.

[out] plId

Указатель на целое число, возвращаемое поставщиком, которое однозначно идентифицирует обновляемое перечисление.

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

Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в

ПримечаниеHRESULT

Предоставленный класс должен указывать допустимый класс, предоставляемый поставщиком High-Performance. Все экземпляры возвращаемого перечислителя можно запрашивать после вызовов. При каждом вызове обновления количество экземпляров в перечислителье может отличаться. Возвращаются только экземпляры указанного имени класса; Подклассы указанного класса не будут перечисляться, так как подробное перечисление не поддерживается. Возвращаемый перечислитель не должен касаться клиента во время выполнения операции обновления . Возвращаемый идентификатор может использоваться функцией Remove для удаления объекта. Обратите внимание, что пользователю необязательно явно удалять добавленные перечислители. Однако клиент должен вызывать Release для возвращаемого перечислителя, если он больше не требуется.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib

См. также раздел

IWbemConfigureRefresher

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