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.
Valor retornado
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 tiver signal instalado uma função de manipulação de sinal para sig, 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âmetro inválido será invocado, 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, confira Estado global no CRT.
Requisitos
| Rotina | Cabeçalho necessário |
|---|---|
raise |
<signal.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.