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

Статья
03/08/2023

Метод 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 для удаления объекта.

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

Требования

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

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

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

IWbemConfigureRefresher

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

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