raise

Envia um sinal para o programa em execução.

Observação

Não use esse método para desligar um aplicativo da Microsoft Store, exceto em cenários de teste ou depuração. As formas programáticas ou de interface do usuário para fechar um aplicativo da Store não são permitidas de acordo com as políticas da Microsoft Store. Para obter mais informações, confira o Ciclo de vida do aplicativo UWP.

Sintaxe

int raise(
   int sig
);

Parâmetros

sig
Sinal a ser gerado.

Retornar valor

Se tiver êxito, raise retornará 0. Caso contrário, retornará um valor diferente de zero.

Comentários

A raise função envia sig para o programa em execução. Se uma chamada anterior para tiver instalado uma função de manipulação de sinal para signalsigo , raise executará essa função. Se nenhuma função de manipulador tiver sido instalada, a ação padrão associada ao valor sig do sinal será executada, da seguinte maneira.

Sinal Descrição Comportamento padrão
SIGABRT Encerramento anormal Termina o programa de chamada com código de saída 3
SIGFPE Erro de ponto flutuante Encerra o programa de chamada
SIGILL Instrução ilegal Encerra o programa de chamada
SIGINT Interrupção CTRL+C Encerra o programa de chamada
SIGSEGV Acesso ao armazenamento inválido Encerra o programa de chamada
SIGTERM Solicitação de término enviado para o programa Ignora o sinal

Se o argumento não for um sinal válido, conforme especificado acima, o manipulador de parâmetros inválido será chamado, conforme descrito em Validação de parâmetro. Se o erro não for tratado, a função define errno como EINVAL e retorna um valor diferente de zero.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Requisitos

Rotina Cabeçalho necessário
raise <signal.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Controle de processos e ambientes
abort
signal