Метод IWbemConfigureRefresher::AddEnum (wbemcli.h)
Метод 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 , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в
Комментарии
Предоставленный класс должен указывать допустимый класс, предоставляемый поставщиком High-Performance. Все экземпляры возвращаемого перечислителя можно запрашивать после вызовов. При каждом вызове обновления количество экземпляров в перечислителье может отличаться. Возвращаются только экземпляры указанного имени класса; Подклассы указанного класса не будут перечисляться, так как подробное перечисление не поддерживается. Возвращаемый перечислитель не должен касаться клиента во время выполнения операции обновления . Возвращаемый идентификатор может использоваться функцией Remove для удаления объекта. Обратите внимание, что пользователю необязательно явно удалять добавленные перечислители. Однако клиент должен вызывать Release для возвращаемого перечислителя, если он больше не требуется.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wbemcli.h (включая Wbemidl.h) |
| Библиотека | Wbemuuid.lib |