_CrtDoForAllClientObjects

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ヒープ内のすべての _CLIENT_BLOCK 型について、アプリケーションが指定した関数を呼び出します (デバッグバージョンだけ)。

void _CrtDoForAllClientObjects( 
   void ( * pfn )( void *, void * ),
   void *context
);

パラメータ

pfn
アプリケーションが指定した呼び出し対象のコールバック関数へのポインタ。この関数の最初のパラメータはデータを指します。2 番目のパラメータは、_CrtDoForAllClientObjects の呼び出しに渡されるコンテキストポインタです。
context
アプリケーションが指定した関数に渡すアプリケーションが指定したコンテキストへのポインタ。

解説

_CrtDoForAllClientObjects 関数は、_CLIENT_BLOCK 型のメモリブロックに対するヒープのリンクリストを検索します。また、この型のメモリブロックが見つかったときに、アプリケーションが指定した関数を呼び出します。見つかったメモリブロックとパラメータ context は、アプリケーションが指定した関数に引数として渡されます。デバッグ時にアプリケーションが特定のグループの割り当てを追跡できるようにするには、デバッグヒープ関数を明示的に呼び出してメモリを割り当て、メモリブロックに _CLIENT_BLOCK 型を割り当てるように指定します。このようにすると、メモリリークの検出時およびメモリ状態のレポート時に、メモリブロックは個別に追跡およびレポートされます。

_crtDbgFlag フラグの _CRTDBG_ALLOC_MEM_DF ビットフィールドが ON になっていない場合、_CrtDoForAllClientObjects はすぐに処理を戻します。_DEBUG が未定義の場合、_CrtDoForAllClientObjects の呼び出しはプリプロセスで削除されます。

_CLIENT_BLOCK 型の詳細およびこれを他のデバッグ関数で使用する方法の詳細については、「デバッグヒープ上のメモリブロックの型」を参照してください。デバッグバージョンのベースヒープに対するメモリブロックの割り当て、初期化、管理方法の詳細については、「メモリ管理とデバッグヒープ」を参照してください。

pfn が NULL の場合は、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、この関数は errno、_doserrno、_sys_errlist、および _sys_nerr を EINVAL に設定して処理を戻します。