Partilhar via


enumeração EVT_SEEK_FLAGS (winevt.h)

Define a posição relativa no conjunto de resultados do qual buscar.

Syntax

typedef enum _EVT_SEEK_FLAGS {
  EvtSeekRelativeToFirst = 1,
  EvtSeekRelativeToLast = 2,
  EvtSeekRelativeToCurrent = 3,
  EvtSeekRelativeToBookmark = 4,
  EvtSeekOriginMask = 7,
  EvtSeekStrict = 0x10000
} EVT_SEEK_FLAGS;

Constantes

 
EvtSeekRelativeToFirst
Valor: 1
Busque o deslocamento especificado da primeira entrada no conjunto de resultados. O deslocamento deve ser um valor positivo.
EvtSeekRelativeToLast
Valor: 2
Busque o deslocamento especificado da última entrada no conjunto de resultados. O deslocamento deve ser um valor negativo.
EvtSeekRelativeToCurrent
Valor: 3
Busque o deslocamento especificado da entrada atual no conjunto de resultados. O deslocamento pode ser um valor positivo ou negativo.
EvtSeekRelativeToBookmark
Valor: 4
Busque o deslocamento especificado da entrada marcada no conjunto de resultados. O deslocamento pode ser um valor positivo ou negativo.
EvtSeekOriginMask
Valor: 7
Uma máscara de bits que você pode usar para determinar qual dos seguintes sinalizadores está definido:


  • EvtSeekRelativeToFirst

  • EvtSeekRelativeToLast

  • EvtSeekRelativeToBookmark

EvtSeekStrict
Valor: 0x10000
Force a função a falhar se o evento não existir.

Comentários

Se o deslocamento ou o indicador buscar além do limite do conjunto de resultados (após o primeiro ou último registro) e EvtSeekStrict não estiver definido, seek retornará o último registro dentro do limite.

Se o indicador estiver dentro dos limites do conjunto de resultados (com base na ID do registro de evento), mas não estiver incluído no conjunto de resultados, a função seek aplicará o deslocamento em relação à ID do registro do indicador. Na tabela a seguir, a primeira coluna mostra as IDs de registro dos eventos no conjunto de resultados. Se a ID do registro do indicador for 3989, a segunda coluna mostrará o registro que a função seek procuraria para receber o deslocamento especificado.

ID do Registro Deslocamento
3995 –2
3991 –1
3987 0, 1
3983 2
3979 3
3975 4
3971 5
3968 6
3959 7
3955 8

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

EvtSeek