EvtGetExtendedStatus-Funktion (winevt.h)

  • Artikel

Ruft eine Textnachricht ab, die die erweiterten Fehlerinformationen für den aktuellen Fehler enthält.

Syntax

DWORD EvtGetExtendedStatus(
  [in]  DWORD  BufferSize,
  [in]  LPWSTR Buffer,
  [out] PDWORD BufferUsed
);

Parameter

[in] BufferSize

Die Größe des Pufferpuffers in Zeichen.

[in] Buffer

Ein vom Aufrufer zugewiesener Zeichenfolgenpuffer, der die erweiterten Fehlerinformationen empfängt. Sie können diesen Parameter auf NULL festlegen, um die erforderliche Puffergröße zu bestimmen.

[out] BufferUsed

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

Rückgabewert

Der Rückgabewert ist ERROR_SUCCESS, wenn der Aufruf erfolgreich war. andernfalls ein Win32-Fehlercode.

Hinweise

Sie müssen diese Funktion für den Thread aufrufen, der den Fehler generiert hat, und bevor Sie eine andere Windows-Ereignisprotokollfunktion aufrufen.

Die Funktionen EvtQuery und EvtSubscribe können erweiterte Fehlerinformationen bereitstellen, wenn ein Problem mit dem angegebenen XPath vorliegt. Beispielsweise können die Fehlerinformationen das Zeichen im XPath identifizieren, in dem ein Analysefehler aufgetreten ist. Um die erweiterten Fehlerinformationen für einen falsch formatierten XPath zu erhalten, können Sie beim Aufrufen von EvtQuery oder EvtSubscribe nicht das EvtQueryTolerateQueryErrors-Flag angeben.

Anforderungen

   
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