_CrtMemCheckpoint

Ruft den aktuellen Zustand des Debugheaps ab und speichert ihn in einer von der Anwendung bereitgestellten _CrtMemState -Struktur (nur Debugversion).

Syntax

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Parameter

state
Zeiger auf die _CrtMemState -Struktur, die mit dem Arbeitsspeicherprüfpunkt ausgefüllt werden soll.

Hinweise

Die _CrtMemCheckpoint -Funktion erstellt eine Momentaufnahme des aktuellen Zustands des Debugheaps eines beliebigen Moments. Diese Momentaufnahme können von anderen Heap-Zustandsfunktionen verwendet werden, z_CrtMemDifference. B. um Speicherverluste und andere Probleme zu erkennen. Wenn _DEBUG sie nicht definiert ist, werden die Aufrufe _CrtMemState während der Vorverarbeitung entfernt.

Die Anwendung muss einen Zeiger zu einer bereits zugeordneten Instanz der _CrtMemState -Struktur, die in Crtdbg.h definiert ist, im state -Parameter übergeben. Wenn _CrtMemCheckpoint bei der Prüfpunkterstellung einen Fehler erkennt, generiert die Funktion einen _CRT_WARN -Debugbericht, der das Problem beschreibt.

Weitere Informationen zu Heap-Zustandsfunktionen und der _CrtMemState Struktur finden Sie unter Heap-Statusberichtsfunktionen. Weitere Informationen dazu, wie Speicherblöcke in der Debugversion des Basis heap zugeordnet, initialisiert und verwaltet werden, finden Sie unter CRT Debug Heap Details.

Ist state dies NULLder Fehler, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, errnowird _doserrno_sys_errlistsie festgelegt EINVAL und _sys_nerr die Funktion zurückgegeben.

Anforderungen

Routine Erforderlicher Header
_CrtMemCheckpoint <crtdbg.h>, <errno.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Bibliotheken: nur Debugversionen der UCRT.

Siehe auch

Debugroutinen
_CrtMemDifference