_CrtMemCheckpoint
Ruft den aktuellen Zustand des Debugheaps und speichert in einer von der Anwendung bereitgestellt _CrtMemState Struktur (nur Debugversion).
void _CrtMemCheckpoint(
_CrtMemState *state
);
Parameter
- state
Zeiger auf dem Arbeitsspeicher zu füllen prüfpunkt _CrtMemState Struktur.
Hinweise
Die _CrtMemCheckpoint-Funktion erstellt eine Momentaufnahme des aktuellen Zustands des Debugheaps jederzeit.Diese Momentaufnahme zustands Heap kann von anderen Funktionen wie _CrtMemCheckpoint verwendet werden, um Speicherverluste und andere Probleme erkannt wird.Wenn _DEBUG nicht definiert wird, werden Aufrufe _CrtMemState während des Präprozessorlaufs entfernt.
Die Anwendung muss einen Zeiger auf eine zuvor zugeordneten Instanz der _CrtMemState Struktur in Crtdbg.h definiert wird, im state-Parameter.Wenn _CrtMemCheckpoint einen Fehler bei der Erstellung von Prüfpunkt auftritt, generiert die Funktion einen _CRT_WARN Debugbericht, der das Problem beschreibt.
Weitere Informationen über Funktionen zur zustands Heap und die _CrtMemState Struktur finden Sie unter Berichtsfunktionen für den Heapzustand.Weitere Informationen zum Speicherblöcke in der Debugversion des Basisheaps zugeordnet, initialisiert und verwaltet werden, finden Sie unter Speicherverwaltung und Debugheap.
Wenn stateNULLungültige Parameter ist, wird der Ereignishandler aufgerufen, wie in Parametervalidierungbeschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno, _doserrno, _sys_errlist und _sys_nerr zu EINVAL festgelegt, und die Funktion gibt zurück.
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_CrtMemCheckpoint |
<crtdbg.h> und <errno.h> |
Weitere Informationen finden Sie unter Kompatibilität Kompatibilität in der Einführung.
Bibliotheken: Debugversionen von nur CRT-Bibliotheks-Funktionen .
Beispiel
Weitere Informationen finden Sie unter crt_dbg1.
.NET Framework-Entsprechung
Nicht zutreffend. Um die Standard-C-Funktion aufrufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.