Funzione RaiseFailFastException (errhandlingapi.h)

Articolo
02/26/2024

Genera un'eccezione che ignora tutti i gestori di eccezioni (frame o vettore basato su). La generazione di questa eccezione termina l'applicazione e richiama Segnalazione errori Windows, se Segnalazione errori Windows è abilitata.

Sintassi

void RaiseFailFastException(
  [in, optional] PEXCEPTION_RECORD pExceptionRecord,
  [in, optional] PCONTEXT          pContextRecord,
  [in]           DWORD             dwFlags
);

Parametri

[in, optional] pExceptionRecord

Puntatore a una struttura EXCEPTION_RECORD contenente le informazioni sull'eccezione. È necessario specificare i membri ExceptionAddress e ExceptionCode .

Se questo parametro è NULL, la funzione crea un record di eccezione e imposta il membro ExceptionCode su STATUS_FAIL_FAST_EXCEPTION. La funzione imposta anche il membro ExceptionAddress se il parametro dwFlags contiene il flag di FAIL_FAST_GENERATE_EXCEPTION_ADDRESS.

[in, optional] pContextRecord

Puntatore a una struttura CONTEXT contenente le informazioni sul contesto. Se NULL, questa funzione genera il contesto (tuttavia, il contesto non corrisponde esattamente al contesto del chiamante).

[in] dwFlags

È possibile specificare zero o il flag seguente che controlla il comportamento di questa funzione:

Valore	Significato
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS 0x1	Causa l'impostazione di ExceptionAddress di EXCEPTION_RECORD all'indirizzo restituito di questa funzione (l'istruzione successiva nel chiamante dopo la chiamata a RaiseFailFastException). Questa funzione imposta l'indirizzo di eccezione solo se ExceptionAddress non è NULL.

Valore restituito

nessuno

Osservazioni

In genere, si chiama questa funzione se l'applicazione è in uno stato non valido e si vuole terminare immediatamente l'applicazione e avere un report di errore di Windows creato.

Se il servizio WER è disabilitato o non è possibile avviare o non è presente alcun debugger collegato al processo, il processo verrà terminato.

Questa funzione genera una seconda eccezione di probabilità. Se il debug JIT è abilitato, un debugger verrà collegato al processo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	errhandlingapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Environment.FailFast

Condividi tramite