_set_abort_behavior

Specifies the action to be taken when a program aborts.

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 aborted. The message states in English that the application has requested the runtime to terminate it in an unusual way and suggests that the user contact the application's support team for more information. The default behavior is to print the message. _CALL_REPORTFAULT, if set, specifies that a Watson crash dump is generated and reported whenabort is called. Crash dump reporting is enabled by default.

Requirements

Routine

Required header

_set_abort_behavior

<stdlib.h>

For more compatibility information, see Compatibility in the Introduction.

Example

// crt_set_abort_behavior.c
// compile with: /c
#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

Concepts

abort