_heapset

ヒープの最小限の一貫性をチェックし、空きエントリを指定した値に設定します。

重要

この関数は廃止されています。 Visual Studio 2015 以降、CRT で使用できません。

構文

int _heapset(
   unsigned int fill
);

パラメーター

fill
充填文字。

戻り値

_heapset は、Malloc.h に定義されている次の整数のマニフェスト定数のいずれかを返します。

Value	説明
_HEAPBADBEGIN	初期ヘッダー情報が無効または見つかりません。
_HEAPBADNODE	ヒープが破損しているか、不適切なノードが見つかりました。
_HEAPEMPTY	ヒープが初期化されていません。
_HEAPOK	ヒープは一貫性があると思われます。

また、エラーが発生した場合、 _heapset は errno を ENOSYSに設定します。

解説

_heapset 関数は、誤って上書きされた空きメモリの場所またはノードを示します。

_heapset は、ヒープの最小限の一貫性をチェックし、ヒープの空きエントリの各バイトに fill 値を設定します。 この既知の値は、空きノードがあるヒープのメモリ位置を示すとともに、解放されたメモリに誤って書き込まれたデータを含むのはどれかを示します。 オペレーティング システムがサポート _heapsetされていない場合 (Windows 98 など)、関数は戻り _HEAPOK 値を設定 errno します ENOSYS。

必要条件

ルーチンによって返される値	必須ヘッダー	オプション ヘッダー
_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 );
}

OK - heap is fine

関連項目

メモリ割り当て
_heapadd
_heapchk
_heapmin
_heapwalk