enumerazione EVT_SEEK_FLAGS (winevt.h)

Articolo
03/04/2024

Definisce la posizione relativa nel set di risultati da cui cercare.

Sintassi

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

Costanti


`EvtSeekRelativeToFirst` Valore: 1 Cercare l'offset specificato dalla prima voce del set di risultati. L'offset deve essere un valore positivo.
`EvtSeekRelativeToLast` Valore: 2 Cercare l'offset specificato dall'ultima voce del set di risultati. L'offset deve essere un valore negativo.
`EvtSeekRelativeToCurrent` Valore: 3 Cercare l'offset specificato dalla voce corrente nel set di risultati. L'offset può essere un valore positivo o negativo.
`EvtSeekRelativeToBookmark` Valore: 4 Cercare l'offset specificato dalla voce segnalibra nel set di risultati. L'offset può essere un valore positivo o negativo.
`EvtSeekOriginMask` Valore: 7 Maschera di bit che è possibile usare per determinare quale dei flag seguenti è impostato: EvtSeekRelativeToFirst EvtSeekRelativeToLast EvtSeekRelativeToBookmark
`EvtSeekStrict` Valore: 0x10000 Forzare l'esito negativo della funzione se l'evento non esiste.

Commenti

Se l'offset o il segnalibro cerca oltre il limite del set di risultati (passato il primo o l'ultimo record) e EvtSeekStrict non è impostato, la ricerca restituirà l'ultimo record entro il limite.

Se il segnalibro si trova entro i limiti del set di risultati (in base all'ID record evento) ma non è incluso nel set di risultati, la funzione di ricerca applicherà l'offset rispetto all'ID record del segnalibro. Nella tabella seguente la prima colonna mostra gli ID record degli eventi nel set di risultati. Se l'ID record del segnalibro è 3989, la seconda colonna mostra il record che la funzione di ricerca cercherebbe di specificare l'offset specificato.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	winevt.h

Vedi anche

EvtSeek

Condividi tramite