EVT_QUERY_FLAGS Enumeration (winevt.h)

Definiert die Werte, die angeben, wie die Abfrageergebnisse zurückgegeben werden sollen und ob Sie eine Abfrage für einen Kanal oder eine Protokolldatei durchführen.

Syntax

typedef enum _EVT_QUERY_FLAGS {
  EvtQueryChannelPath = 0x1,
  EvtQueryFilePath = 0x2,
  EvtQueryForwardDirection = 0x100,
  EvtQueryReverseDirection = 0x200,
  EvtQueryTolerateQueryErrors = 0x1000
} EVT_QUERY_FLAGS;

Konstanten

 
EvtQueryChannelPath
Wert: 0x1
Gibt an, dass die Abfrage für einen oder mehrere Kanäle gilt. Der Path-Parameter der EvtQuery-Funktion muss den Namen eines Kanals oder NULL angeben.
EvtQueryFilePath
Wert: 0x2
Gibt an, dass die Abfrage für eine oder mehrere Protokolldateien verwendet wird. Der Path-Parameter der EvtQuery-Funktion muss den vollständigen Pfad zu einer Protokolldatei oder NULL angeben.
EvtQueryForwardDirection
Wert: 0x100
Gibt an, dass die Ereignisse im Abfrageergebnis von der ältesten zur neuesten sortiert werden. Dies ist die Standardoption.
EvtQueryReverseDirection
Wert: 0x200
Gibt an, dass die Ereignisse im Abfrageergebnis von der neuesten zur ältesten sortiert werden.
EvtQueryTolerateQueryErrors
Wert: 0x1000
Gibt an, dass EvtQuery die Abfrage ausführen soll, auch wenn der Teil der Abfrage einen Fehler generiert (ist nicht wohlgeformt). Der Dienst überprüft die Syntax der XPath-Abfrage, um festzustellen, ob sie wohlgeformt ist. Wenn die Überprüfung fehlschlägt, analysiert der Dienst den XPath in einzelne Ausdrücke. Es erstellt einen neuen XPath, der mit dem links meisten Ausdruck beginnt. 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 Prozess, bis er den Ausdruck findet, der fehlschlägt. Anschließend werden die gültigen Ausdrücke verwendet, die sie gefunden hat, beginnend mit dem äußerst 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 EvtQuery-Aufruf fehl.

Bemerkungen

Die Flags "EvtQueryChannelPath" und "EvtQueryFilePath" schließen sich gegenseitig aus. Die Flags EvtQueryForwardDirection und EvtQueryReverseDirection schließen sich ebenfalls gegenseitig aus.

Sie können Ereignisse nur in Vorwärtsrichtung aus Debug- und Analysekanälen und aus .evt- und ETL-Protokolldateien abrufen.

Requirements

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Nur Desktop-Apps]
Header winevt.h

Siehe auch

EvtQuery

  • Zuletzt aktualisiert um