Compartilhar via


_CrtMemCheckpoint

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

void _CrtMemCheckpoint(    _CrtMemState *state  );

Parâmetros

  • state
    Ponteiro para _CrtMemState estrutura para preencher com o ponto de verificação de memória.

Comentários

O _CrtMemCheckpoint função cria um instantâneo do estado atual do heap de depuração a qualquer momento. Esse instantâneo pode ser usado por outras funções de estado de heap como _CrtMemDifference para 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 previamente alocada a _CrtMemState estrutura, definida em crtdbg. h, no state parâmetro. Se _CrtMemCheckpoint encontra um erro durante a criação do ponto de verificação, a função gera uma _CRT_WARN depurar relatório descrevendo o problema.

Para obter mais informações sobre funções de estado de heap e o _CrtMemState estrutura, consulte funções de relatório do estado de 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 da pilha de depuração CRT.

Se state for NULL, o manipulador de parâmetros inválido será invocado, como descrito em Validação do parâmetro. Se a execução puder continuar, errno, _doserrno, _sys_errlist e _sys_nerr será definido para EINVAL e a função será retornada.

Requisitos

Rotina

Cabeçalho necessário

_CrtMemCheckpoint

<crtdbg.h>, <errno.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Bibliotecas: versões de depuração do Recursos da biblioteca CRT apenas.

Exemplo

Consulte crt_dbg1.

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.

Consulte também

Referência

Rotinas de depuração

_CrtMemDifference