Поделиться через


_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, and _sys_nerr задается значение EINVAL и функция возвращается.

Требования

Подпрограмма

Обязательный заголовок

_CrtMemCheckpoint

<crtdbg.h>, <errno.h>

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

Библиотеки: только отладочные версии Функции библиотеки CRT.

Пример

См. раздел crt_dbg1.

Эквивалент в .NET Framework

Неприменимо. Для вызова стандартной функции C используйте PInvoke. Для получения дополнительной информации см. Примеры вызовов неуправляемого кода.

См. также

Ссылки

Процедуры отладки

_CrtMemDifference