_CrtMemCheckpoint

Получает текущее состояние отладочной кучи и сохраняет его в предоставленной приложением структуре _CrtMemState (только отладочная версия).

Синтаксис

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Параметры

state
Указатель на структуру _CrtMemState для заполнения контрольными точками памяти.

Замечания

Функция _CrtMemCheckpoint создает моментальный снимок текущего состояния отладочной кучи в любой данный момент. Этот моментальный снимок можно использовать другими функциями состояния кучи, например _CrtMemDifference для обнаружения утечек памяти и других проблем. Если _DEBUG это не определено, вызовы _CrtMemState удаляются во время предварительной обработки.

Приложение должно передать указатель в выделенный ранее экземпляр структуры _CrtMemState , определенный в файле Crtdbg.h в параметре state . Если при создании контрольной точки возникает ошибка _CrtMemCheckpoint , функция создает отчет об отладке _CRT_WARN , описывающий проблему.

Дополнительные сведения о функциях состояния кучи и _CrtMemState структуре см. в разделе "Отчеты о состоянии кучи". Дополнительные сведения о выделении, инициализации и управлении блоками памяти в отладочной версии базовой кучи см. в сведениях об отладочной куче CRT.

В противном state NULLслучае вызывается недопустимый обработчик параметров, как описано в разделе "Проверка параметров". Если выполнение разрешено продолжить, errno, _doserrno, _sys_errlistи задано значение EINVAL и _sys_nerr функция возвращается.

Требования

Маршрут	Обязательный заголовок
_CrtMemCheckpoint	<crtdbg.h>, <errno.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Библиотеки: только отладочные версии UCRT.

См. также

Отладка подпрограмм
_CrtMemDifference