_onexit, _onexit_m

終了時に呼び出されるルーチンを登録します。

構文

_onexit_t _onexit(
   _onexit_t function
);
_onexit_t_m _onexit_m(
   _onexit_t_m function
);

パラメーター

function
終了時に呼び出される関数へのポインター。

戻り値

_onexit は、成功した場合は関数へのポインターを返し、関数ポインターを格納するスペースがない場合は NULL します。

解説

_onexit 関数には、プログラムが正常に終了したときに呼び出される関数 (function) のアドレスが渡されます。 _onexit を連続して呼び出すと、LIFO (後入先出法) 順で実行される関数のレジスタが作成されます。 _onexitに渡される関数はパラメーターを受け取ることはできません。

が DLL 内から呼び出された場合、_onexitに登録されたルーチンは、DLL_PROCESS_DETACHでDllMainが呼び出された後、DLL がアンロードされたときに実行されます。

_onexit は Microsoft 拡張機能です。 ANSI 移植性を実現するには、 atexitを使用します。 _onexit_m バージョンの関数は、混在モード用です。

要件

互換性の詳細については、「 Compatibility」を参照してください。

例

// crt_onexit.c

#include <stdlib.h>
#include <stdio.h>

/* Prototypes */
int fn1(void), fn2(void), fn3(void), fn4 (void);

int main( void )
{
   _onexit( fn1 );
   _onexit( fn2 );
   _onexit( fn3 );
   _onexit( fn4 );
   printf( "This is executed first.\n" );
}

int fn1()
{
   printf( "next.\n" );
   return 0;
}

int fn2()
{
   printf( "executed " );
   return 0;
}

int fn3()
{
   printf( "is " );
   return 0;
}

int fn4()
{
   printf( "This " );
   return 0;
}

出力

This is executed first.
This is executed next.

関連項目

プロセスと環境の制御
atexit
exit、 _Exit、 _exit
__dllonexit