_heapset
チェックは最小限の一貫性を持たせるために蓄積し指定された値の無料エントリを設定します。
int _heapset(
unsigned int fill
);
パラメーター
- fill
入力文字。
戻り値
_heapset は Malloc.h で定義されているマニフェスト定数の整数の 1 を返します。
_HEAPBADBEGIN
無効な場合最初のヘッダー情報。_HEAPBADNODE
検索破損したかノードを累積します。_HEAPEMPTY
初期化します。_HEAPOK
ヒープが一貫して表示されます。
またエラーが発生すると_heapset は ENOSYS に errno を設定します。
解説
_heapset の関数は誤って上書きされたノードまたはメモリの位置を示します。
ヒープの最小の整合性を _heapset のチェックは fill の値にヒープの空きエントリの各バイトを設定します。この既知の値がヒープ上のメモリ位置は無料のノードが含まれますが解放されたメモリに誤ってに書き込まれたデータを含んでいるかを示します。オペレーティング システムが _heapset(たとえばWindows 98) をサポートする関数の戻り値 _HEAPOK は ENOSYS に errno を設定します。
必要条件
ルーチン |
必須ヘッダー |
オプション ヘッダー |
|---|---|---|
_heapset |
<malloc.h> |
<errno.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_heapset.c
// This program checks the heap and
// fills in free entries with the character 'Z'.
#include <malloc.h>
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
int heapstatus;
char *buffer;
if( (buffer = malloc( 1 )) == NULL ) // Make sure heap is
exit( 0 ); // initialized
heapstatus = _heapset( 'Z' ); // Fill in free entries
switch( heapstatus )
{
case _HEAPOK:
printf( "OK - heap is fine\n" );
break;
case _HEAPEMPTY:
printf( "OK - heap is empty\n" );
break;
case _HEAPBADBEGIN:
printf( "ERROR - bad start of heap\n" );
break;
case _HEAPBADNODE:
printf( "ERROR - bad node in heap\n" );
break;
}
free( buffer );
}
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。