_CrtMemCheckpoint
Ruft den aktuellen Zustand des Debugheaps ab und speichert ihn in einer von der Anwendung bereitgestellten _CrtMemState-Struktur (nur Debugversion).
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 kann von anderen Heapzustandsfunktionen wie _CrtMemDifference verwendet werden, um beim Erkennen von Speicherverlusten und anderen Problemen zu unterstützen. Wenn _DEBUG nicht definiert ist, werden Aufrufe von _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 über Heapzustandsfunktionen und die _CrtMemState-Struktur finden Sie unter Berichtsfunktionen für den Heapzustand. Weitere Informationen darüber, wie Speicherblöcke in der Debugversion des Basisheaps zugeordnet, initialisiert und verwaltet werden, finden Sie unter Details zum CRT-Debugheap.
Wenn state den Wert NULL annimmt, wird der ungültige Parameterhandler, wie in Parametervalidierung beschrieben, aufgerufen. Wenn die weitere Ausführung zugelassen wird, wird errno, _doserrno, _sys_errlist und _sys_nerr auf EINVAL gesetzt, und die Funktion wird zurückgegeben.
Anforderungen
Routine |
Erforderlicher Header |
---|---|
_CrtMemCheckpoint |
<crtdbg.h>, <errno.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken: nur Debugversionen von CRT-Bibliotheksfunktionen.
Beispiel
Siehe crt_dbg1.
.NET Framework-Entsprechung
Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.