指定されたメモリ ブロックがローカル ヒープ内にあり、有効なデバッグ ヒープ ブロック型識別子が設定されていることを検査します (デバッグ バージョンだけ)。
構文
int _CrtIsMemoryBlock(
const void *userData,
unsigned int size,
long *requestNumber,
char **filename,
int *lineNumber
);
パラメーター
userData
検査するメモリ ブロックの先頭へのポインター。
size
指定されたブロックのサイズ (バイト)。
requestNumber
ブロックの割り当て番号へのポインター、または NULL。
filename
ブロックを要求したソース ファイル名へのポインター、または NULL。
lineNumber
ソース ファイル内の行番号へのポインター、または NULL。
戻り値
_CrtIsMemoryBlock は、指定されたメモリ ブロックがローカル ヒープにあり、有効なデバッグ ヒープ ブロック型識別子が設定されていれば、TRUE を返します。それ以外の場合は、FALSE を返します。
解説
_CrtIsMemoryBlock 関数は、指定されたメモリ ブロックがアプリケーションのローカル ヒープ内にあり、有効なブロック型識別子が設定されていることを検査します。 また、この関数を使用すると、オブジェクト割り当て順序番号と、メモリ ブロックの割り当て要求を行ったソース ファイル名および行番号を取得できます。 requestNumber、filename、または lineNumber パラメーターで渡されたNULL以外の値を指定すると、ローカル ヒープ内のブロックが見つかると、_CrtIsMemoryBlockはメモリ ブロックのデバッグ ヘッダー内の値にパラメーターを設定します。 _DEBUG が定義されていない場合、_CrtIsMemoryBlock の呼び出しは前処理で削除されます。
_CrtIsMemoryBlockが失敗した場合、FALSEが返され、出力パラメーターは既定値に初期化されます。requestNumberとlineNumberは 0 に設定され、filenameは NULL に設定されます。
この関数は TRUE または FALSEを返すので、 _ASSERT マクロのいずれかに渡して、基本的なデバッグ エラー処理メカニズムを作成できます。 次の例では、指定されたアドレスがローカル ヒープ内にない場合にアサーションの失敗が発生します。
_ASSERTE( _CrtIsMemoryBlock( userData, size, &requestNumber,
&filename, &linenumber ) );
他のデバッグ関数やマクロで _CrtIsMemoryBlock を使用する方法の詳細については、「 Macros for reportingを参照してください。 基本ヒープのデバッグ バージョンでのメモリ ブロックの割り当て、初期化、および管理方法については、「 CRT デバッグ ヒープの詳細を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_CrtIsMemoryBlock |
<crtdbg.h> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのデバッグ バージョンのみ。
例
_CrtIsValidHeapPointer記事の例を参照してください。