Compartilhar via


Interface IWbemEventSink (wbemprov.h)

A interface IWbemEventSink inicia a comunicação com um provedor de eventos usando um conjunto restrito de consultas. Essa interface estende o IWbemObjectSink, fornecendo novos métodos que lidam com segurança e desempenho. Para obter mais informações sobre o uso dessa interface, consulte Escrevendo um provedor de eventos e Protegendo eventos WMI.

Herança

A interface IWbemEventSink herda da interface IUnknown . IWbemEventSink também tem esses tipos de membros:

Métodos

A interface IWbemEventSink tem esses métodos.

 
IWbemEventSink::GetRestrictedSink

O método IWbemEventSink::GetRestrictedSink recupera um coletor de eventos restrito. Um coletor de eventos restrito é aquele que filtra um subconjunto dos eventos definidos no registro do provedor de eventos.
IWbemEventSink::IsActive

O método IWbemEventSink::IsActive é usado pelo provedor para determinar se há interesse nos eventos que o coletor está filtrando.
IWbemEventSink::SetBatchingParameters

O método IWbemEventSink::SetBatchingParameters é usado para definir o tamanho máximo do buffer de eventos e seu valor de latência de processamento associado.
IWbemEventSink::SetSinkSecurity

Usado para definir um descritor de segurança (SD) em um coletor para todos os eventos que passam.

Comentários

Ao implementar um coletor de assinatura de evento (IWbemObjectSink ou IWbemEventSink), não chame o WMI de dentro dos métodos no objeto coletor. Por exemplo, chamar o IWbemServices::CancelAsyncCall para cancelar o coletor de dentro de uma implementação de IWbemEventSink::SetSinkSecurity pode interferir no estado do WMI. Para cancelar uma assinatura de evento, defina um sinalizador e chame o IWbemServices::CancelAsyncCall de outro thread ou objeto. Para implementações que não estejam relacionadas a um coletor de eventos, como recuperações de objeto, enumeração e consulta, você pode fazer uma chamada de volta para o WMI.

As implementações do coletor devem processar a notificação de evento dentro de 100 milissegundos, pois o thread do WMI que entrega a notificação de evento não pode executar outras tarefas até que o objeto coletor tenha concluído o processamento. Se a notificação exigir uma grande quantidade de processamento, o coletor poderá usar uma fila interna para outro thread para lidar com o processamento.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemprov.h (inclua Wbemidl.h)

Confira também

API COM para WMI