PFN_WER_RUNTIME_EXCEPTION_EVENT funzione di callback (werapi.h)

Articolo
03/03/2024

Segnalazione errori Windows (WER) chiama questa funzione per determinare se il gestore delle eccezioni richiede l'arresto anomalo.

Il tipo di PFN_WER_RUNTIME_EXCEPTION_EVENT definisce un puntatore a questa funzione di callback. È necessario usare "OutOfProcessExceptionEventCallback" come nome della funzione di callback.

Sintassi

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
)
{...}

Parametri

[in] pContext

Puntatore a informazioni di contesto arbitrarie specificate quando si chiama la funzione WerRegisterRuntimeExceptionModule per registrare il gestore eccezioni .

[in] pExceptionInformation

Struttura WER_RUNTIME_EXCEPTION_INFORMATION contenente le informazioni sull'eccezione. Usare le informazioni per determinare se si vuole richiedere l'arresto anomalo.

[out] pbOwnershipClaimed

Impostare su TRUE se il gestore di eccezioni richiede questo arresto anomalo; in caso contrario, FALSE. Se si imposta questo parametro su FALSE, non impostare il resto dei parametri out.

[out] pwszEventName

Buffer allocato dal chiamante usato per specificare il nome dell'evento usato per identificare questo arresto anomalo.

[in, out] pchSize

Dimensioni, in caratteri, del buffer pwszEventName . Il buffer è limitato a MAX_PATH caratteri. Le dimensioni includono il carattere null-terminazione.

[out] pdwSignatureCount

Numero di parametri del report forniti. L'intervallo valido di valori è uno a 10. Se si specifica un valore maggiore di 10, WER ignora il valore e raccoglie solo i primi 10 parametri. Se si specifica zero, il processo di creazione di report sarà indeterminato.

Questo valore determina il numero di volte in cui WER chiama la funzione OutOfProcessExceptionEventSignatureCallback .

Valore restituito

Restituisce S_OK, anche se il gestore eccezioni non richiede questo arresto anomalo. Se si restituiscono altri codici di errore, WER ripristina il comportamento predefinito per la segnalazione degli arresti anomali se non vengono registrati altri gestori.

Commenti

È necessario implementare questa funzione nella DLL del gestore eccezioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	werapi.h

Vedi anche

WerRegisterRuntimeExceptionModule, Segnalazione errori Windows

Condividi tramite