Skip to content

raise.md

Latest commit

 

History

History
106 lines (92 loc) · 3.45 KB

raise.md

File metadata and controls

106 lines (92 loc) · 3.45 KB
title raise | Microsoft Docs
ms.custom
ms.date 11/04/2016
ms.reviewer
ms.suite
ms.technology
cpp-standard-libraries
ms.tgt_pltfrm
ms.topic article
apiname
raise
apilocation
msvcrt.dll
msvcr80.dll
msvcr90.dll
msvcr100.dll
msvcr100_clr0400.dll
msvcr110.dll
msvcr110_clr0400.dll
msvcr120.dll
msvcr120_clr0400.dll
ucrtbase.dll
api-ms-win-crt-runtime-l1-1-0.dll
apitype DLLExport
f1_keywords
Raise
dev_langs
C++
helpviewer_keywords
signals, sending to executing programs
raise function
signals
programs [C++], sending signals to executing programs
ms.assetid a3ccd3ad-f68f-4a7b-a005-c3ebfb217e8b
caps.latest.revision 14
author corob-msft
ms.author corob
manager ghogen
translation.priority.ht
de-de
es-es
fr-fr
it-it
ja-jp
ko-kr
ru-ru
zh-cn
zh-tw
translation.priority.mt
cs-cz
pl-pl
pt-br
tr-tr

raise

Sends a signal to the executing program.

Note

Do not use this method to shut down a [!INCLUDEwin8_appname_long] app, except in testing or debugging scenarios. Programmatic or UI ways to close a [!INCLUDEwin8_appname_long] app are not permitted according to Section 3.6 of the Windows 8 app certification requirements. For more information, see Application lifecycle (Windows Store apps).

Syntax

  
      int raise(  
int sig   
);

Parameters

sig
Signal to be raised.

Return Value

If successful, raise returns 0. Otherwise, it returns a nonzero value.

Remarks

The raise function sends sig to the executing program. If a previous call to signal has installed a signal-handling function for sig, raise executes that function. If no handler function has been installed, the default action associated with the signal value sig is taken, as follows.

Signal Meaning Default
SIGABRT Abnormal termination Terminates the calling program with exit code 3
SIGFPE Floating-point error Terminates the calling program
SIGILL Illegal instruction Terminates the calling program
SIGINT CTRL+C interrupt Terminates the calling program
SIGSEGV Illegal storage access Terminates the calling program
SIGTERM Termination request sent to the program Ignores the signal

If the argument is not a valid signal as specified above, the invalid parameter handler is invoked, as described in Parameter Validation. If not handled, the function sets errno to EINVAL and returns a nonzero value.

Requirements

Routine Required header
raise <signal.h>

For additional compatibility information, see Compatibility.

Libraries

All versions of the C run-time libraries.

See Also

Process and Environment Control
abort
signal