enumeração EVT_SUBSCRIBE_FLAGS (winevt.h)

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