Share via


anular

Aborta o processo corrente e retorna um código de erro.

void abort( void );

Valor de retorno

abort não retornar o controle ao processo de chamada. Por padrão, ele termina o processo corrente e retorna um código de sair de 3.

Comentários

Por padrão, a abort rotina imprime a mensagem:

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

Em seguida, ele chama raise(SIGABRT). A ação executada em resposta à SIGABRT sinal depende da ação que tem sido definida para esse sinal em uma telefonar anterior da signal função. O padrão de SIGABRT ação é para o processo de chamada terminar com código de sair 3, retornando o controle para o processo de chamada ou sistema operacional. abort não limpar os buffers de fluxo ou fazer atexit/_onexit o processamento.

abort Determina o destino da mensagem com base no tipo de aplicativo que chamou a rotina. Aplicativos de console sempre receber a mensagem por meio de stderr. Em um único ou vários segmentos com base em baseado no Windows aplicativo, abort chamadas do baseado no Windows MessageBox função para criar uma caixa de mensagem para exibir a mensagem com um OK botão.Quando o usuário clica OK, o programa será anulada imediatamente.A mensagem pode ser individualmente suprimida chamando _set_abort_behavior os argumentos apropriados.

Quando o aplicativo está vinculado com uma versão de depurar das bibliotecas de time de execução, abort cria uma caixa de mensagem com três botões: Anular, Tente novamente, and Ignorar.Se o usuário clicar em Anular, o programa será anulada imediatamente.Se o usuário clicar em Tente novamente, o depurador é chamado e o usuário pode depurar o programa se a depuração do just-in-time (JIT) estiver ativada.Se o usuário clicar em Ignorar, abort continua com sua execução normal: criar a caixa de mensagem com o OK botão.

In Visual C++ 2005, abort também chama um mecanismo para relatório de falhas para a Microsoft de relatório de erros. Esse comportamento pode ser desabilitado chamando _set_abort_behavior.

Para obter mais informações sobre depuração de CRT, consulte CRT Debugging Techniques.

Requisitos

Rotina

Cabeçalho necessário

abort

<processo.h> ou <stdlib.h>

Exemplo

O seguinte programa tenta em em aberto um arquivo e será anulada se a tentativa falhar.

// crt_abort.c
// compile with: /c
// 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 );
    }
}

File could not be opened: No such file or directory  This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information.

Equivalente do NET Framework

Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Using anular

The anular Função

Processo e ambiente de controle

_exec, _wexec funções

sair, _exit

aumentar

sinal

_spawn, _wspawn funções

_DEBUG

_set_abort_behavior