_CrtCheckMemory

Artigo
02/25/2013

Confirma a integridade dos blocos de memória alocada na pilha de depuração (somente a versão de depuração).

int _CrtCheckMemory( void );

Valor de retorno

Se for bem-sucedido, _CrtCheckMemory retorna TRUE; Caso contrário, a função retornará FALSE.

Comentários

O _CrtCheckMemory função valida a memória alocada pelo Gerenciador de heap de depuração através da verificação de pilha base subjacente e inspecionar cada bloco de memória.Se for encontrada uma inconsistência de erro ou memória na pilha base subjacente, as informações de cabeçalho de depuração ou os buffers de substituição, _CrtCheckMemory gera um relatório de depuração com informações que descrevam a condição de erro.Quando _ Debug não está definido, planos de _CrtCheckMemory são removidos durante o pré-processamento.

O comportamento do _CrtCheckMemory pode ser controlado, definindo os campos de bit da _crtDbgFlag sinalizar usando o _CrtSetDbgFlag função.Ativando o _CRTDBG_CHECK_ALWAYS_DF resultados Diante do campo de bit _CrtCheckMemory que está sendo chamada sempre que uma operação de alocação de memória é solicitada.Embora esse método lento em execução, ele é útil para a captura de erros rapidamente.Ativando o _CRTDBG_ALLOC_MEM_DF causas de fora do campo de bit _CrtCheckMemory para não verificar a pilha e retornar imediatamente TRUE.

Esta função retorna TRUE ou FALSE, ele pode ser passado para uma da _ASSERT macros para criar um simples mecanismo de tratamento de erros de depuração.O exemplo a seguir faz com que um erro de declaração se a corrupção é detectada na heap:

_ASSERTE( _CrtCheckMemory( ) );

Para obter mais informações sobre como _CrtCheckMemory pode ser usado com outras funções de depuração, consulte Funções de emissão de relatórios de estado de Heap.Para uma visão geral do gerenciamento de memória e a pilha de depuração, consulte Gerenciamento de memória e a pilha de depuração.