_set_abort_behavior
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at _set_abort_behavior.
Specifies the action to be taken when a program is abnormally terminated.
Note
Do not use the abort function to shut down a Windows 8.x Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Windows 8.x Store app are not permitted according to the Windows 8 app certification requirements. For more information, see Application lifecycle (Windows Store apps).
Syntax
unsigned int _set_abort_behavior(
unsigned int flags,
unsigned int mask
);
Parameters
[in] flags
New value of the abort flags.
[in] mask
Mask for the abort flags bits to set.
Return Value
The old value of the flags.
Remarks
There are two abort flags: _WRITE_ABORT_MSG and _CALL_REPORTFAULT. _WRITE_ABORT_MSG determines whether a helpful text message is printed when a program is abnormally terminated. The message states that the application has called the abort function. The default behavior is to print the message. _CALL_REPORTFAULT, if set, specifies that a Watson crash dump is generated and reported when abort is called. By default, crash dump reporting is enabled in non-DEBUG builds.
Requirements
| Routine | Required header |
|---|---|
_set_abort_behavior |
<stdlib.h> |
For more compatibility information, see Compatibility.
Example
// crt_set_abort_behavior.c
// compile with: /TC
#include <stdlib.h>
int main()
{
printf("Suppressing the abort message. If successful, this message"
" will be the only output.\n");
// Suppress the abort message
_set_abort_behavior( 0, _WRITE_ABORT_MSG);
abort();
}
Suppressing the abort message. If successful, this message will be the only output.