EVT_SEEK_FLAGS-Enumeration (winevt.h)

Artikel
03/06/2024

Definiert die relative Position im Resultset, von der gesucht werden soll.

Syntax

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

Konstanten


`EvtSeekRelativeToFirst` Wert: 1 Suchen Sie nach dem angegebenen Offset des ersten Eintrags im Resultset. Der Offset muss ein positiver Wert sein.
`EvtSeekRelativeToLast` Wert: 2 Suchen Sie nach dem angegebenen Offset des letzten Eintrags im Resultset. Der Offset muss ein negativer Wert sein.
`EvtSeekRelativeToCurrent` Wert: 3 Suchen Sie nach dem angegebenen Offset des aktuellen Eintrags im Resultset. Der Offset kann ein positiver oder negativer Wert sein.
`EvtSeekRelativeToBookmark` Wert: 4 Suchen Sie nach dem angegebenen Offset des als Lesezeichen markierten Eintrags im Resultset. Der Offset kann ein positiver oder negativer Wert sein.
`EvtSeekOriginMask` Wert: 7 Eine Bitmaske, mit der Sie bestimmen können, welche der folgenden Flags festgelegt ist: EvtSeekRelativeToFirst EvtSeekRelativeToLast EvtSeekRelativeToBookmark
`EvtSeekStrict` Wert: 0x10000 Erzwingen Sie, dass die Funktion fehlschlägt, wenn das Ereignis nicht vorhanden ist.

Hinweise

Wenn der Offset oder das Lesezeichen die Grenze des Resultsets (über den ersten oder letzten Datensatz hinaus) sucht und EvtSeekStrict nicht festgelegt ist, gibt seek den letzten Datensatz innerhalb der Begrenzung zurück.

Wenn sich das Lesezeichen innerhalb der Grenzen des Resultsets befindet (basierend auf der Ereignisdatensatz-ID), aber nicht im Resultset enthalten ist, wendet die Suchfunktion den Offset relativ zur Datensatz-ID des Lesezeichens an. In der folgenden Tabelle werden in der ersten Spalte die Datensatz-IDs der Ereignisse im Resultset angezeigt. Wenn die Datensatz-ID des Lesezeichens 3989 ist, zeigt die zweite Spalte den Datensatz an, den die Suchfunktion angesichts des angegebenen Offsets suchen würde.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	winevt.h

Weitere Informationen

EvtSeek

Freigeben über