Метод 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 для возвращаемого объекта, когда он больше не требуется.

Требования

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

Доступ к данным о производительности в C++

IWbemConfigureRefresher

Превращение поставщика экземпляра в поставщик High-Performance

Поставщик счетчиков производительности