_CrtMemCheckpoint

Obtém o estado corrente da depurar heap e armazena em um aplicativo fornecido _CrtMemState estrutura (somente versão de depurar).

void _CrtMemCheckpoint(
   _CrtMemState *state 
);

Parâmetros

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

Comentários

The _CrtMemCheckpoint função cria um instantâneo do estado corrente da pilha de depurar em qualquer dado momento. Esse instantâneo pode ser usado por outras funções de estado de heap para ajudar a detectar vazamentos de memória e outros problemas.Quando _DEBUG não foi definido, chamadas para _CrtMemState serão removidos durante a pré-processamento.

O aplicativo deve passar um ponteiro para uma instância do anteriormente alocada**_CrtMemState** estrutura, definida de Crtdbg.h, nas state parâmetro. If _CrtMemCheckpoint encontrar um erro durante a criação de ponto de verificação, a função gera um _CRT_WARN Depure 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órioss de estado de heap. Para obter mais informações sobre como os blocos de memória são alocados, inicializado e gerenciado na versão de depurar do heap de base, consulte Gerenciamento de memória e a pilha de Depurar.

If state é NULL, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, errno, _doserrno, _sys_errlist e _sys_nerr é conjunto para EINVAL e a função retorna.

Requisitos

Rotina

Cabeçalho necessário

_CrtMemCheckpoint

<crtdbg.h>, <errno.h>

Para obter mais informações de compatibilidade, consulte Compatibility na introdução.

Bibliotecas: Versões de depurar de C em time de execução bibliotecas somente.

Exemplo

SeeExemplo de crt_dbg1: C Basic Run-Time Depurando recursos.

Equivalente do NET Framework

Não aplicável. Para telefonar 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 depurar