PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE Rückruffunktion (werapi.h)

Artikel
03/03/2024

Windows-Fehlerberichterstattung (WER) ruft diese Funktion auf, um die Berichtsparameter abzurufen, die das Problem eindeutig beschreiben.

Der PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE-Typs definiert einen Zeiger auf diese Rückruffunktion. Sie müssen "OutOfProcessExceptionEventSignatureCallback" als Namen der Rückruffunktion verwenden.

Syntax

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE PfnWerRuntimeExceptionEventSignature;

HRESULT PfnWerRuntimeExceptionEventSignature(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [in]      DWORD dwIndex,
  [out]     PWSTR pwszName,
  [in, out] PDWORD pchName,
  [out]     PWSTR pwszValue,
  [in, out] PDWORD pchValue
)
{...}

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.

[in] dwIndex

Der Index des Berichtsparameters. Gültige Werte sind 0 bis 9. Beim ersten Aufruf dieser Funktion muss der Index auf 0 festgelegt werden, und jeder aufeinander folgende Aufruf muss den Indexwert sequenziell erhöhen.

[out] pwszName

Ein vom Aufrufer zugewiesener Puffer, den Sie zum Angeben des Parameternamens verwenden.

[in, out] pchName

Die Größe des pwszName-Puffers in Zeichen. Die Größe enthält das NULL-Endzeichen.

[out] pwszValue

Ein vom Aufrufer zugewiesener Puffer, den Sie verwenden, um den Parameterwert anzugeben.

[in, out] pchValue

Die Größe des pwszValue-Puffers in Zeichen. Die Größe enthält das NULL-Endzeichen.

Rückgabewert

Geben Sie S_OK nach Erfolg zurück. Wenn Sie andere Fehlercodes zurückgeben, wird das standardmäßige Absturzberichterstattungsverhalten von WER wieder verwendet.

Hinweise

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

Um Fehlerberichte für anwendungsspezifische Probleme zu generieren, muss die Anwendung eine kurze Beschreibung des Problems erstellen, indem einige grundlegende Informationen verwendet werden, die als Berichtsparameter bezeichnet werden. Berichtsparameter enthalten Informationen wie Anwendungsname, Anwendungsversion, Modulname, Modulversion und Fehlercode. Die Kombination dieser Berichtsparameter beschreibt ein eindeutiges Problem.

WER ruft diese Rückruffunktion nur auf, wenn Sie den pbOwnershipClaimed-Parameter Ihrer OutOfProcessExceptionEventCallback-Rückruffunktion auf TRUE festlegen. Der pdwSignatureCount-Parameter von OutOfProcessExceptionEventCallback bestimmt die Häufigkeit, mit der WER diese Rückruffunktion aufruft.

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