_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 estructura _CrtMemState, consulte Funciones que indican el estado del montón. Para 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, tal y 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.