PFN_WER_RUNTIME_EXCEPTION_EVENT Rückruffunktion (werapi.h)

Artikel
07/27/2023

Windows-Fehlerberichterstattung (WER) ruft diese Funktion auf, um zu bestimmen, ob der Ausnahmehandler den Absturz beansprucht.

Der PFN_WER_RUNTIME_EXCEPTION_EVENT Typ definiert einen Zeiger auf diese Rückruffunktion. Sie müssen "OutOfProcessExceptionEventCallback" als Namen der Rückruffunktion verwenden.

Syntax

PFN_WER_RUNTIME_EXCEPTION_EVENT PfnWerRuntimeExceptionEvent;

HRESULT PfnWerRuntimeExceptionEvent(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [out]     BOOL *pbOwnershipClaimed,
  [out]     PWSTR pwszEventName,
  [in, out] PDWORD pchSize,
  [out]     PDWORD pdwSignatureCount
)
{...}

Parameter

[in] pContext

Ein Zeiger auf beliebige Kontextinformationen, die Sie beim Aufrufen der WerRegisterRuntimeExceptionModule-Funktion angegeben haben, um den Ausnahmehandler zu registrieren.

[in] pExceptionInformation

Eine WER_RUNTIME_EXCEPTION_INFORMATION-Struktur , die die Ausnahmeinformationen enthält. Verwenden Sie die Informationen, um zu bestimmen, ob Sie den Absturz in Anspruch nehmen möchten.

[out] pbOwnershipClaimed

Legen Sie auf TRUE fest, wenn der Ausnahmehandler diesen Absturz beansprucht. andernfalls FALSE. Wenn Sie diesen Parameter auf FALSE festlegen, legen Sie nicht den Rest der out-Parameter fest.

[out] pwszEventName

Ein vom Aufrufer zugewiesener Puffer, den Sie verwenden, um den Ereignisnamen anzugeben, der zum Identifizieren dieses Absturzes verwendet wird.

[in, out] pchSize

Die Größe des pwszEventName-Puffers in Zeichen. Der Puffer ist auf MAX_PATH Zeichen beschränkt. Die Größe enthält das NULL-Endzeichen.

[out] pdwSignatureCount

Die Anzahl der Berichtsparameter, die Sie bereitstellen. Der gültige Wertebereich ist eins bis 10. Wenn Sie einen Wert größer als 10 angeben, ignoriert WER den Wert und erfasst nur die ersten 10 Parameter. Wenn Sie null angeben, ist der Berichterstellungsprozess unbestimmt.

Dieser Wert bestimmt die Häufigkeit, mit der WER Ihre OutOfProcessExceptionEventSignatureCallback-Funktion aufruft .

Rückgabewert

Gibt S_OK zurück, auch wenn der Ausnahmehandler diesen Absturz nicht beansprucht. Wenn Sie andere Fehlercodes zurückgeben, kehrt WER auf das standardmäßige Absturzberichtsverhalten zurück, wenn keine anderen Handler registriert sind.

Hinweise

Sie müssen diese Funktion in Ihrer Ausnahmehandler-DLL implementieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	werapi.h

Weitere Informationen

WerRegisterRuntimeExceptionModule, Windows-Fehlerberichterstattung

Share via