_set_abort_behavior

Article
06/05/2017

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.

Share via