_heapset
チェックが最小との一貫性を保つためにします。また、指定した値に自由なエントリが設定されます。
int _heapset(
unsigned int fill
);
パラメーター
- fill
Fill 文字。
戻り値
_heapset は、Malloc.h に定義されている次の整数のマニフェスト定数のいずれかを返します。
_HEAPBADBEGIN
初期ヘッダー情報が無効または見つかりません。_HEAPBADNODE
ヒープが破損しているか、不適切なノードが見つかりました。_HEAPEMPTY
ヒープが初期化されていません。_HEAPOK
ヒープは、一貫しているようです。
また、エラーが発生した場合、_heapset は errno を ENOSYS に設定します。
解説
_heapset 関数は誤って上書きされたノードまたはメモリ位置を示します。
_heapset は ヒープの最小の一貫性をチェックし、fill 値にヒープの空きエントリの各バイトを設定します。 この既知の値はヒープ上のメモリ位置を自由なノードが含まれ、None が解放されたメモリに意図せずに書き込まれたデータを含んでいるかを示します。 オペレーティング システムが _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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。