Метод IWbemServices::QueryObjectSink (wbemcli.h)

Статья
08/27/2023

Метод IWbemServices::QueryObjectSink позволяет вызывающей объекту получить обработчик уведомлений, экспортируемый службой управления Windows. Это позволяет вызывающей объекту записывать уведомления и события непосредственно в службу управления Windows. Вызывающий объект должен записывать в управление Windows только события extrinsic. Дополнительные сведения см. в разделе Определение типа получаемого события.

Синтаксис

HRESULT QueryObjectSink(
  [in]  long            lFlags,
  [out] IWbemObjectSink **ppResponseHandler
);

Параметры

[in] lFlags

Зарезервировано. Этот параметр должен иметь значение 0.

[out] ppResponseHandler

Получает указатель интерфейса на обработчик уведомлений. При возникновении ошибки для этого параметра задано значение NULL . Возвращаемый указатель имеет положительное число ссылок, и вызывающий объект должен вызывать IWbemServices::Release для указателя, когда он больше не нужен. Значение NULL может быть возвращено, если обработчик уведомлений недоступен. Это не ошибка.

Примечание Значение параметра ppResponseHandler не может иметь значение NULL при его передаче в этот метод.

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

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

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

Примечание Запуск событий с помощью QueryObjectSink разрешен по умолчанию только для администраторов. Чтобы расширить разрешение на других пользователей, необходимо предоставить им WBEM_FULL_WRITE разрешение.

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

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

IWbemObjectSink

IWbemServices

Запрос WMI

Поделиться через