Метод IWbemConfigureRefresher::AddObjectByTemplate (wbemcli.h)
С помощью метода IWbemConfigureRefresher::AddObjectByTemplate можно добавить объект, который требуется обновить в средство обновления, указав шаблон экземпляра IWbemClassObject . Используйте этот метод, если трудно создать путь к объекту для добавления в средство обновления.
Синтаксис
HRESULT AddObjectByTemplate(
IWbemServices *pNamespace,
[in] IWbemClassObject *pTemplate,
[in] long lFlags,
[in] IWbemContext *pContext,
[out] IWbemClassObject **ppRefreshable,
[out] long *plId
);
Параметры
pNamespace
Указатель IWbemServices обратно на управление Windows, который может обслуживать любой запрос, сделанный поставщиком. Поставщик должен вызвать AddRef для этого указателя, если он собирается вернуться к управлению Windows во время его выполнения.
[in] pTemplate
Указатель на объект IWbemClassObject , содержащий шаблон экземпляра.
[in] lFlags
Битовая маска флагов, которые изменяют поведение этого метода. Если для этого параметра задано значение WBEM_FLAG_USE_AMENDED_QUALIFIERS, возвращаемый экземпляр будет содержать локализованные квалификаторы, если они доступны.
[in] pContext
Обычно — NULL; В противном случае — указатель на объект IWbemContext , необходимый одному или нескольким поставщикам динамических классов. Значения в объекте контекста должны быть указаны в документации конкретного поставщика. Дополнительные сведения об этом параметре см. в статье Вызовы WMI.
[out] ppRefreshable
Указатель для хранения ссылки на объект IWbemClassObject , который будет содержать обновляемый объект экземпляра. Клиент должен вызывать Release для возвращаемого объекта, когда он больше не требуется.
[out] plId
Указатель на целое число, возвращаемое поставщиком, которое однозначно идентифицирует этот обновляемый объект.
Возвращаемое значение
Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT.
Комментарии
Предоставленный экземпляр должен указывать допустимый объект, предоставляемый поставщиком High-Performance. Возвращаемый объект не должен быть изменен клиентом во время операции обновления. Возвращаемый идентификатор может использоваться функцией Remove для удаления объекта.
Пользователю необязательно явно удалять добавленные объекты. Клиент должен вызывать Release для возвращаемого объекта, когда он больше не требуется.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wbemcli.h (включая Wbemidl.h) |
| Библиотека | Wbemuuid.lib |
См. также раздел
Доступ к данным о производительности в C++
Превращение поставщика экземпляра в поставщик High-Performance