| title | raise | Microsoft Docs | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ms.custom | ||||||||||||
| ms.date | 11/04/2016 | |||||||||||
| ms.reviewer | ||||||||||||
| ms.suite | ||||||||||||
| ms.technology |
|
|||||||||||
| ms.tgt_pltfrm | ||||||||||||
| ms.topic | article | |||||||||||
| apiname |
|
|||||||||||
| apilocation |
|
|||||||||||
| apitype | DLLExport | |||||||||||
| f1_keywords |
|
|||||||||||
| dev_langs |
|
|||||||||||
| helpviewer_keywords |
|
|||||||||||
| ms.assetid | a3ccd3ad-f68f-4a7b-a005-c3ebfb217e8b | |||||||||||
| caps.latest.revision | 14 | |||||||||||
| author | corob-msft | |||||||||||
| ms.author | corob | |||||||||||
| manager | ghogen |
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).
int raise(
int sig
);
sig
Signal to be raised.
If successful, raise returns 0. Otherwise, it returns a nonzero value.
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.
| Routine | Required header |
|---|---|
| raise | <signal.h> |
For additional compatibility information, see Compatibility.
All versions of the C run-time libraries.