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

  • Статья

Метод 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