_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 Microsoft Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the Microsoft Store policies. For more information, see UWP app lifecycle.

Syntax

unsigned int _set_abort_behavior(
   unsigned int flags,
   unsigned int mask
);

Parameters

flags
New value of the abort flags.

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.

See also

abort