_CrtMemCheckpoint

Obtiene el estado actual del montón de depuración y lo almacena en una estructura de _CrtMemState proporcionada por la aplicación (solo versión de depuración).

Sintaxis

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Parámetros

state
Puntero a la estructura de _CrtMemState que se va a rellenar con el punto de control de memoria.

Comentarios

La función _CrtMemCheckpoint crea una instantánea del estado actual del montón de depuración en cualquier momento determinado. Otras funciones de estado del montón pueden usar esta instantánea, como _CrtMemDifference para ayudar a detectar pérdidas de memoria y otros problemas. Cuando _DEBUG no se define, las llamadas a _CrtMemState se quitan durante el preprocesamiento.

La aplicación debe pasar un puntero a una instancia de la estructura de _CrtMemState previamente asignada, definida en Crtdbg.h, en el parámetro state . Si _CrtMemCheckpoint encuentra un error durante la creación del punto de control, la función genera un informe de depuración de _CRT_WARN en el que se describe el problema.

Para obtener más información sobre las funciones de estado del montón y la _CrtMemState estructura, consulte Funciones de informes de estado del montón. Para obtener más información sobre cómo se asignan, inicializan y administran los bloques de memoria en la versión de depuración del montón base, consulte Detalles del montón de depuración de CRT.

Si state es NULL, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, errno, _doserrno, _sys_errlisty _sys_nerr se establece EINVAL en y la función devuelve.

Requisitos

Routine	Encabezado necesario
_CrtMemCheckpoint	<crtdbg.h>, <errno.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Bibliotecas: solo versiones de depuración de la UCRT.

Consulte también

Rutinas de depuración
_CrtMemDifference