raise
Sends a signal to the executing program.
Note
Do not use this method to shut down a Windows Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Windows Store 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
);
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 in the Introduction.
Libraries
All versions of the C run-time libraries.
.NET Framework Equivalent
Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.