abort

Articolo
06/09/2015

Interrompe il processo corrente e restituisce un codice di errore.

Nota

Non utilizzare questo metodo per interrompere un'applicazione Windows Store, eccetto che negli scenari di test o di debug.Le modalità dell'interfaccia utente o a livello di codice per chiudere un'app di Windows Store non sono consentite come descritto in Requisiti di certificazione delle app di Windows 8.Per ulteriori informazioni, vedere Ciclo di vita delle applicazioni (app di Windows Store).

void abort( void );

Valore restituito

abort non restituisce il controllo al processo chiamante. Per impostazione predefinita, verifica la disponibilità di un gestore del segnale di interruzione e genera SIGABRT se uno è impostato. Quindi abort termina il processo corrente e restituisce un codice di uscita al processo padre.

Note

Specifici di Microsoft

Per impostazione predefinita, quando un'applicazione viene compilata con la libreria di runtime di debug, la routine abort visualizza un messaggio di errore prima che venga generato SIGABRT. Per le applicazioni di console in esecuzione in modalità di console, il messaggio viene inviato a STDERR. Le applicazioni desktop di Windows e le applicazioni console eseguite in modalità a finestra visualizzano il messaggio in una finestra di messaggio. Per eliminare il messaggio, utilizzare _set_abort_behavior per rimuovere il flag _WRITE_ABORT_MSG. Il messaggio visualizzato dipende dalla versione dell'ambiente di runtime in uso. Per le applicazioni compilate con la versione più recente di Visual C++, il messaggio è simile al seguente:

R6010

- abort() has been called

Nelle versioni precedenti della libreria di runtime C, viene visualizzato questo messaggio:

"This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information."

Quando il programma viene compilato in modalità di debug, la finestra di messaggio visualizza le opzioni Interrompi, Riprova o Ignora. Se l'utente sceglie Interrompi, il programma termina immediatamente e restituisce il codice di uscita 3. Se l'utente sceglie Riprova, viene chiamato un debugger per il debug JIT, se disponibile. Se l'utente sceglie Ignora, abort continua l'elaborazione normale.

In entrambi le build di debug e per la vendita, abort controlla quindi se è impostato un gestore di interruzione del segnale. Se è impostato un gestore di segnale non predefinito, abort chiama raise(SIGABRT). Utilizzare la funzione signal per associare una funzione di gestione di interruzione del segnale al segnale SIGABRT. È possibile eseguire azioni personalizzate, ad esempio la pulizia delle risorse o la registrazione di informazioni, e terminare l'applicazione con il proprio codice di errore nella funzione di gestione. Se non viene definito un gestore di segnale personalizzato, abort non genera il segnale SIGABRT.

Per impostazione predefinita, nelle compilazioni non di debug del desktop o nelle applicazioni di console, abort richiama il meccanismo di segnalazione errori di Windows (Dr. Watson) per segnalare gli errori a Microsoft. Questo comportamento può essere abilitato o disabilitato chiamando _set_abort_behavior e impostando o mascherando il flag _CALL_REPORTFAULT. Quando il flag è impostato, Windows visualizza una finestra di messaggio che contiene un messaggio analogo al seguente: "Si è verificato un problema che impedisce il funzionamento corretto del programma". L'utente può scegliere di richiamare un debugger con un pulsante Debug oppure scegliere il pulsante Chiudi programma per terminare l'applicazione con un codice di errore definito dal sistema operativo.

Se il gestore di Segnalazione errori Windows non viene richiamato, abort chiama _exit per terminare il processo con il codice di uscita 3 e il controllo viene restituito al processo padre o al sistema operativo. _exit non svuota i buffer del flusso o esegue l'elaborazione di atexit/_onexit.

Per ulteriori informazioni sul debug di CRT, vedere Tecniche di debug CRT.

Specifica END Microsoft

Requisiti

Routine	Intestazione obbligatoria
abort	<process.h> o <stdlib.h>

Esempio

Il seguente programma tenta di aprire un file e si interrompe se il tentativo fallisce.

// crt_abort.c
// compile with: /TC
// This program demonstrates the use of
// the abort function by attempting to open a file
// and aborts if the attempt fails.

#include  <stdio.h>
#include  <stdlib.h>

int main( void )
{
    FILE    *stream = NULL;
    errno_t err = 0;

    err = fopen_s(&stream, "NOSUCHF.ILE", "r" );
    if ((err != 0) || (stream == NULL))
    {
        perror( "File could not be opened" );
        abort();
    }
    else
    {
        fclose( stream );
    }
}