Compartilhar via

enumeração EVT_SUBSCRIBE_FLAGS (winevt.h)

  • Artigo

Define os valores possíveis que especificam quando começar a assinar eventos.

Syntax

typedef enum _EVT_SUBSCRIBE_FLAGS {
  EvtSubscribeToFutureEvents = 1,
  EvtSubscribeStartAtOldestRecord = 2,
  EvtSubscribeStartAfterBookmark = 3,
  EvtSubscribeOriginMask = 3,
  EvtSubscribeTolerateQueryErrors = 0x1000,
  EvtSubscribeStrict = 0x10000
} EVT_SUBSCRIBE_FLAGS;

Constantes

 
EvtSubscribeToFutureEvents
Valor: 1
Assine somente eventos futuros que correspondam aos critérios de consulta.
EvtSubscribeStartAtOldestRecord
Valor: 2
Assine todos os eventos existentes e futuros que correspondam aos critérios de consulta.
EvtSubscribeStartAfterBookmark
Valor: 3
Assine todos os eventos existentes e futuros que correspondam aos critérios de consulta que começam após o evento marcado. Se você incluir o sinalizador EvtSubscribeStrict, a função EvtSubscribe falhará se o evento marcado não existir. Se você não incluir o sinalizador EvtSubscribeStrict e o evento com indicadores não existir, a assinatura começará com o evento que está após o evento mais próximo do evento marcado.
EvtSubscribeOriginMask
Valor: 3
Uma máscara de bits que você pode usar para determinar qual dos seguintes sinalizadores está definido:


  • EvtSubscribeToFutureEvents

  • EvtSubscribeStartAtOldestRecord

  • EvtSubscribeStartAfterBookmark
EvtSubscribeTolerateQueryErrors
Valor: 0x1000
Conclua a assinatura mesmo que a parte da consulta gere um erro (não está bem formada). O serviço valida a sintaxe da consulta XPath para determinar se ela está bem formada. Se a validação falhar, o serviço analisará o XPath em expressões individuais. Ele cria um novo XPath começando com a expressão mais à esquerda. O serviço valida a expressão e, se ela for válida, o serviço adicionará a próxima expressão ao XPath. O serviço repete esse processo até encontrar a expressão que está falhando. Em seguida, ele usa as expressões válidas encontradas começando com a expressão mais à esquerda como a consulta XPath (o que significa que você pode não obter os eventos esperados). Se nenhuma parte do XPath for válida, a chamada EvtSubscribe falhará.
EvtSubscribeStrict
Valor: 0x10000
Força a chamada EvtSubscribe a falhar se você especificar EvtSubscribeStartAfterBookmark e o evento com indicador não for encontrado (o valor retornado é ERROR_NOT_FOUND). Além disso, defina esse sinalizador se você quiser receber notificação no retorno de chamada quando os registros de evento estiverem ausentes.

Comentários

Os sinalizadores EvtSubscribeToFutureEvents, EvtSubscribeStartAtOldestRecord e EvtSubscribeStartAfterBookmark são mutuamente exclusivos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho winevt.h

Confira também

EvtSubscribe