_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 NULL
der Fehler, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, errno
wird _doserrno
_sys_errlist
sie 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Feedback senden und anzeigen für