Funzione UnhandledExceptionFilter (errhandlingapi.h)

Articolo
08/23/2023

Funzione definita dall'applicazione che passa eccezioni non gestite al debugger, se il processo viene sottoposto a debug. In caso contrario, viene visualizzata facoltativamente una finestra di messaggio Di errore dell'applicazione e il gestore eccezioni viene eseguito. Questa funzione può essere chiamata solo dall'interno dell'espressione di filtro di un gestore eccezioni.

Sintassi

LONG UnhandledExceptionFilter(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
);

Parametri

[in] ExceptionInfo

Puntatore a una struttura EXCEPTION_POINTERS che specifica una descrizione dell'eccezione e del contesto del processore al momento dell'eccezione. Questo puntatore è il valore restituito di una chiamata alla funzione GetExceptionInformation .

Valore restituito

La funzione restituisce uno dei valori seguenti.

Codice/valore restituito	Descrizione
EXCEPTION_CONTINUE_SEARCH 0x0	Il processo viene sottoposto a debug, quindi l'eccezione deve essere passata (come seconda possibilità) al debugger dell'applicazione.
EXCEPTION_EXECUTE_HANDLER 0x1	Se il flag SEM_NOGPFAULTERRORBOX è stato specificato in una chiamata precedente a SetErrorMode, non viene visualizzata alcuna finestra di messaggio Di errore dell'applicazione. La funzione restituisce il controllo al gestore eccezioni, che è libero di eseguire qualsiasi azione appropriata.

Commenti

Se il processo non viene sottoposto a debug, la funzione visualizza una finestra di messaggio di errore dell'applicazione , a seconda della modalità di errore corrente. Il comportamento predefinito consiste nel visualizzare la finestra di dialogo, ma può essere disabilitata specificando SEM_NOGPFAULTERRORBOX in una chiamata alla funzione SetErrorMode .

Il sistema usa internamente UnhandledExceptionFilter per gestire le eccezioni che si verificano durante la creazione di processi e thread.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	errhandlingapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll