_heapset
Verifica pilhas consistência mínima e define as entradas livres com um valor especificado.
int _heapset(
unsigned int fill
);
Parâmetros
- fill
Caractere de preenchimento.
Valor de retorno
_heapsetRetorna uma das seguintes constantes de manifesto de inteiro definidas em Malloc.h.
_HEAPBADBEGIN
Informações de cabeçalho inicial inválidas ou não foi encontradas._HEAPBADNODE
Heap danificados ou defeituoso nó encontrado._HEAPEMPTY
Pilha não inicializada._HEAPOK
Heap parece estar consistente.
Além disso, se ocorrer um erro, _heapset define errno para ENOSYS.
Comentários
O _heapset função mostra os locais de memória livre ou nós que foram acidentalmente substituídos.
_heapsetverifica a consistência mínima na pilha e define cada byte de entradas livres da pilha para o fill valor.Este valor conhecido mostra quais locais de memória da pilha contêm nós livres e que contêm dados que foram gravados, inadvertidamente, memória liberada.Se o sistema operacional não suporta _heapset(por exemplo, Windows 98), a função retornará _HEAPOK e define errno para ENOSYS.
Requisitos
Rotina |
Cabeçalho necessário |
Cabeçalho opcional |
---|---|---|
_heapset |
<malloc.h> |
<errno.h> |
Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.
Exemplo
// 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 );
}
Equivalência do .NET Framework
Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.