raise.md

title	ms.custom	ms.date	ms.reviewer	ms.suite	ms.technology	ms.tgt_pltfrm	ms.topic	apiname	apilocation	apitype	f1_keywords	dev_langs	helpviewer_keywords	ms.assetid	caps.latest.revision	author	ms.author	manager
raise | Microsoft Docs		11/04/2016			cpp-standard-libraries		article	raise	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	DLLExport	Raise	C++	signals, sending to executing programs raise function signals programs [C++], sending signals to executing programs	a3ccd3ad-f68f-4a7b-a005-c3ebfb217e8b	14	corob-msft	corob	ghogen

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