_execute_onexit_table, _initialize_onexit_table, _register_onexit_function
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 _execute_onexit_table, _initialize_onexit_table, _register_onexit_function.
Manages the routines to be called at exit time.
int _initialize_onexit_table(
_onexit_table_t* table
);
int _register_onexit_function(
_onexit_table_t* table,
_onexit_t function
);
int _execute_onexit_table(
_onexit_table_t* table
);
Parameters
[inout] table
Pointer to the onexit function table.
[in] function
Pointer to a function to add to the onexit function table.
If successful, returns 0. Otherwise, returns a negative value.
These functions are infrastructure implementation details used to support the C runtime, and should not be called directly from your code. The C runtime uses an onexit function table to represent the sequence of functions registered by calls to atexit, at_quick_exit, and _onexit. The onexit function table data structure is an opaque implementation detail of the C runtime; the order and meaning of its data members may change. They should not be inspected by external code.
The _initialize_onexit_table function initializes the onexit function table to its initial value. This function must be called before the onexit function table is passed to either _register_onexit_function or _execute_onexit_table.
The _register_onexit_function function appends a function to the end of the onexit function table.
The _execute_onexit_table function executes all of the functions in the onexit function table, clears the table, and then returns. After a call to _execute_onexit_table, the table is in a non-valid state; it must be reinitialized by a call to _initialize_onexit_table before it is used again.
| Routine | Required header |
|---|---|
_initialize_onexit_table function, _register_onexit_function, _execute_onexit_table | C, C++: <process.h> |
The _initialize_onexit_table, _register_onexit_function, and _execute_onexit_table functions are Microsoft specific. For compatibility information, see Compatibility.