_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
| Rotina | Cabeçalho necessário |
|---|---|
_CrtMemCheckpoint |
<crtdbg.h>, <errno.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Bibliotecas: somente versões de depuração do UCRT.