EVT_SUBSCRIBE_FLAGS-Enumeration (winevt.h)

Artikel
08/27/2023

Definiert die möglichen Werte, die angeben, wann mit dem Abonnieren von Ereignissen begonnen werden soll.

Syntax

typedef enum _EVT_SUBSCRIBE_FLAGS {
  EvtSubscribeToFutureEvents = 1,
  EvtSubscribeStartAtOldestRecord = 2,
  EvtSubscribeStartAfterBookmark = 3,
  EvtSubscribeOriginMask = 3,
  EvtSubscribeTolerateQueryErrors = 0x1000,
  EvtSubscribeStrict = 0x10000
} EVT_SUBSCRIBE_FLAGS;

Konstanten


`EvtSubscribeToFutureEvents` Wert: 1 Abonnieren Sie nur zukünftige Ereignisse, die den Abfragekriterien entsprechen.
`EvtSubscribeStartAtOldestRecord` Wert: 2 Abonnieren Sie alle vorhandenen und zukünftigen Ereignisse, die den Abfragekriterien entsprechen.
`EvtSubscribeStartAfterBookmark` Wert: 3 Abonnieren Sie alle vorhandenen und zukünftigen Ereignisse, die den Abfragekriterien entsprechen, die nach dem als Lesezeichen markierten Ereignis beginnen. Wenn Sie das EvtSubscribeStrict-Flag einschließen, schlägt die EvtSubscribe-Funktion fehl, wenn das Lesezeichenereignis nicht vorhanden ist. Wenn Sie das EvtSubscribeStrict-Flag nicht einschließen und das mit Lesezeichen versehene Ereignis nicht vorhanden ist, beginnt das Abonnement mit dem Ereignis, das nach dem Ereignis liegt, das dem lesezeichenten Ereignis am nächsten kommt.
`EvtSubscribeOriginMask` Wert: 3 Eine Bitmaske, mit der Sie bestimmen können, welche der folgenden Flags festgelegt ist: EvtSubscribeToFutureEvents EvtSubscribeStartAtOldestRecord EvtSubscribeStartAfterBookmark
`EvtSubscribeTolerateQueryErrors` Wert: 0x1000 Schließen Sie das Abonnement auch dann ab, wenn der Teil der Abfrage einen Fehler generiert (ist nicht wohlgeformt). Der Dienst überprüft die Syntax der XPath-Abfrage, um zu bestimmen, ob sie wohlgeformt ist. Wenn die Überprüfung fehlschlägt, analysiert der Dienst den XPath in einzelne Ausdrücke. Es erstellt einen neuen XPath beginnend mit dem am weitesten links getretenen Ausdruck. Der Dienst überprüft den Ausdruck, und wenn er gültig ist, fügt der Dienst dem XPath den nächsten Ausdruck hinzu. Der Dienst wiederholt diesen Vorgang, bis er den fehlerhaften Ausdruck findet. Anschließend werden die gültigen Ausdrücke verwendet, die sie gefunden hat, beginnend mit dem äußersten linken Ausdruck als XPath-Abfrage (was bedeutet, dass Sie möglicherweise nicht die erwarteten Ereignisse erhalten). Wenn kein Teil des XPath gültig ist, schlägt der EvtSubscribe-Aufruf fehl.
`EvtSubscribeStrict` Wert: 0x10000 Erzwingt, dass der EvtSubscribe-Aufruf fehlschlägt, wenn Sie EvtSubscribeStartAfterBookmark angeben und das Lesezeichenereignis nicht gefunden wird (der Rückgabewert ist ERROR_NOT_FOUND). Legen Sie dieses Flag auch fest, wenn Sie in Ihrem Rückruf eine Benachrichtigung erhalten möchten, wenn Ereignisdatensätze fehlen.

Hinweise

Die Flags EvtSubscribeToFutureEvents, EvtSubscribeStartAtOldestRecord und EvtSubscribeStartAfterBookmark schließen sich gegenseitig aus.

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

EvtSubscribe

Freigeben über