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

Метод IWbemConfigureRefresher::AddObjectByPath добавляет объект в средство обновления, указывая путь к объекту.

Синтаксис

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Параметры

[in] pNamespace

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

[in] wszPath

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

[in] lFlags

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

[in] pContext

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

[out] ppRefreshable

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

[out] plId

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

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

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

Комментарии

Указанный путь должен указывать допустимый объект, предоставляемый поставщиком High-Performance. Возвращаемый объект не должен касаться клиента во время операции обновления. Возвращаемый идентификатор может использоваться функцией Remove для удаления объекта.

Требования

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

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

IWbemConfigureRefresher

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

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