_CrtMemCheckpoint

Obtém o estado atual do heap de depuração e o armazena em uma estrutura _CrtMemState fornecida pelo aplicativo (somente versão de depuração).

Sintaxe

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Parâmetros

state
Ponteiro para uma estrutura _CrtMemState a ser preenchida com o ponto de verificação de memória.

Comentários

A função _CrtMemCheckpoint cria um instantâneo do estado atual do heap de depuração em determinado momento. Esse instantâneo pode ser usado por outras funções de estado de heap, como _CrtMemDifference ajudar a detectar vazamentos de memória e outros problemas. Quando _DEBUG não está definido, as chamadas para _CrtMemState são removidas durante o pré-processamento.

O aplicativo deve passar um ponteiro para uma instância alocada anteriormente da estrutura _CrtMemState, definida em Crtdbg.h, no parâmetro state. Se _CrtMemCheckpoint encontrar um erro durante a criação do ponto de verificação, a função gerará um relatório de depuração _CRT_WARN descrevendo o problema.

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.

Se state for NULL, o manipulador de parâmetro inválido será chamado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, , , , e _sys_nerr for definido como EINVAL e a função retornar. _sys_errlist_doserrnoerrno

Requisitos

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

Bibliotecas: somente versões de depuração do UCRT.

Confira também

Rotinas de depuração
_CrtMemDifference