_CrtDumpMemoryLeaks

Despeja todos os blocos de memória no heap de depuração quando ocorre uma perda de memória (somente versão de depuração).

Sintaxe

int _CrtDumpMemoryLeaks( void );

Valor retornado

_CrtDumpMemoryLeaks retornará TRUE se for encontrada uma perda de memória. Caso contrário, a função retorna FALSE.

Comentários

A função _CrtDumpMemoryLeaks determina se ocorreu uma perda de memória desde o início da execução do programa. Quando uma perda é encontrada, as informações de cabeçalho de depuração de todos os objetos no heap são despejadas em um formato legível pelo usuário. Quando _DEBUG não está definido, as chamadas para _CrtDumpMemoryLeaks são removidas durante o pré-processamento.

_CrtDumpMemoryLeaks é chamado com frequência ao final da execução do programa para verificar se toda a memória alocada pelo aplicativo foi liberada. A função pode ser chamada automaticamente no encerramento do programa, por meio da ativação do campo de bits _CRTDBG_LEAK_CHECK_DF do sinalizador _crtDbgFlag usando a função _CrtSetDbgFlag.

_CrtDumpMemoryLeaks chama _CrtMemCheckpoint para obter o estado atual do heap e, em seguida, examina o estado em busca de blocos que não foram liberados. Quando um bloco não liberado é encontrado, _CrtDumpMemoryLeaks chama _CrtMemDumpAllObjectsSince para despejar informações de todos os objetos alocados no heap a após o início da execução do programa.

Por padrão, os blocos internos do runtime do C (_CRT_BLOCK) não são incluídos em operações de despejo de memória. A função _CrtSetDbgFlag pode ser usada para ativar o bit _CRTDBG_CHECK_CRT_DF de _crtDbgFlag para incluir esses blocos no processo de detecção de perda.

Para obter mais informações sobre as funções de estado do heap e a estrutura _CrtMemState, consulte Funções de relatório de estado do heap. Para obter mais informações sobre como os blocos de memória são alocados, inicializados e gerenciados na versão de depuração do heap de base, consulte Detalhes do heap de depuração CRT.

Requisitos

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas

Somente versões de depuração de bibliotecas de tempo de execução C.

Exemplo

Para encontrar um exemplo de como usar _CrtDumpMemoryLeaks, confira crt_dbg1.

Confira também

Rotinas de depuração