Método IWbemServices::QueryObjectSink (wbemcli.h)

Artigo
08/27/2023

O método IWbemServices::QueryObjectSink permite que o chamador obtenha um manipulador de notificação exportado pelo Gerenciamento do Windows. Isso permite que o chamador escreva notificações e eventos diretamente no Gerenciamento do Windows. O chamador deve gravar apenas eventos extrínsecos no Gerenciamento do Windows. Para obter mais informações, confira Determinar o tipo de evento a receber.

Sintaxe

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

Parâmetros

[in] lFlags

Reservado. Esse parâmetro deve ser 0.

[out] ppResponseHandler

Recebe o ponteiro de interface para o manipulador de notificação. Isso é definido para apontar para NULL quando há um erro. O ponteiro retornado tem uma contagem de referência positiva e o chamador deve chamar IWbemServices::Release no ponteiro quando ele não for mais necessário. Um valor NULL poderá ser retornado se nenhum manipulador de notificação estiver disponível. Isso não é um erro.

Nota O valor do parâmetro ppResponseHandler não pode ser NULL quando é passado para esse método.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.

Códigos de erro específicos de COM também poderão ser retornados se problemas de rede fizerem com que você perca a conexão remota com o Gerenciamento do Windows.

Nota Disparar eventos usando QueryObjectSink é permitido por padrão somente para Administradores. Estender a permissão para outros usuários requer conceder a eles WBEM_FULL_WRITE permissão.

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (include Wbemidl.h)
Biblioteca	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

Confira também

IWbemObjectSink

IWbemServices

Consultar o WMI

Compartilhar via