EvtGetQueryInfo-Funktion (winevt.h)

Artikel
03/04/2024

Ruft Informationen zu einer Abfrage ab, die Sie ausgeführt haben und die die Liste der Kanäle oder Protokolldateien identifiziert, auf die die Abfrage zugreifen wollte. Die Funktion ruft auch eine Liste von Rückgabecodes ab, die den Erfolg oder Fehler jedes Zugriffs angibt.

Syntax

BOOL EvtGetQueryInfo(
  [in]  EVT_HANDLE            QueryOrSubscription,
  [in]  EVT_QUERY_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

Parameter

[in] QueryOrSubscription

Ein Handle für die Abfrage, die von derEvtQuery - oder EvtSubscribe-Funktion zurückgegeben wird.

[in] PropertyId

Der Bezeichner der abzurufenden Abfrageinformationen. Eine Liste der Bezeichner finden Sie in der EVT_QUERY_PROPERTY_ID-Enumeration .

[in] PropertyValueBufferSize

Die Größe des PropertyValueBuffer-Puffers in Bytes.

[in] PropertyValueBuffer

Ein vom Aufrufer zugeordneter Puffer, der die Abfrageinformationen empfängt. Der Puffer enthält ein EVT_VARIANT-Objekt . Sie können diesen Parameter auf NULL festlegen, um die erforderliche Puffergröße zu bestimmen.

[out] PropertyValueBufferUsed

Die Größe des vom Aufrufer zugewiesenen Puffers in Bytes, den die Funktion verwendet hat, oder die erforderliche Puffergröße, wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
TRUE	Die Funktion wurde erfolgreich ausgeführt.
FALSE	Fehler bei der Funktion. Rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Sie müssen diese Funktion nur aufrufen, wenn Sie das EvtQueryTolerateQueryErrors-Flag an EvtQuery oder das EvtSubscribeTolerateQueryErrors-Flag an EvtSubscribe übergeben.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter Abfragen von Ereignissen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winevt.h
Bibliothek	Wevtapi.lib
DLL	Wevtapi.dll

Weitere Informationen

EvtQuery

EvtSubscribe

Freigeben über