Condividi tramite


Funzione UnhandledExceptionFilter (errhandlingapi.h)

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

Vedere anche

EXCEPTION_POINTERS

GetExceptionInformation

SetErrorMode

SetUnhandledExceptionFilter

Funzioni di gestione delle eccezioni strutturate

Cenni preliminari sulla gestione delle eccezioni strutturate