Freigeben über

EVT_SEEK_FLAGS-Enumeration (winevt.h)

  • Artikel

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