_CrtMemDumpAllObjectsSince

Gibt Informationen zu Objekten im Heap ab Beginn der Programmausführung oder ab einem angegebenen Heapzustand aus (nur Debugversion).

Syntax

void _CrtMemDumpAllObjectsSince(
   const _CrtMemState *state
);

Parameter

state
Zeigen Sie auf den Heap-Zustand, um mit dem Dumping von oder NULL.

Hinweise

Die _CrtMemDumpAllObjectsSince-Funktion gibt die Debugheaderinformationen von Objekten, die im Heap zugeordnet sind, in einer für den Benutzer lesbaren Formular aus. Die Dumpinformationen können von der Anwendung zum Nachverfolgen von Zuordnungen und zum Erkennen von Speicherproblemen verwendet werden. Wenn _DEBUG sie nicht definiert ist, werden die Aufrufe _CrtMemDumpAllObjectsSince während der Vorverarbeitung entfernt.

_CrtMemDumpAllObjectsSince verwendet den Wert des state-Parameters, um zu ermitteln, wo der Dumpvorgang initiiert werden soll. Um mit dem Dumping aus einem angegebenen Heap-Zustand zu beginnen, muss der state Parameter ein Zeiger auf eine _CrtMemState Struktur sein, die vor _CrtMemCheckpoint dem _CrtMemDumpAllObjectsSince Aufruf ausgefüllt wurde. Ist state dies NULLder Zeitpunkt, beginnt die Funktion mit dem Dump vom Anfang der Programmausführung.

Wenn die Anwendung eine Dump-Hook-Funktion durch Aufrufen _CrtSetDumpClientinstalliert hat, ruft sie jedes Mal, wenn _CrtMemDumpAllObjectsSince Informationen zu einem _CLIENT_BLOCK Blocktyp abbilden, auch die von der Anwendung bereitgestellte Dumpfunktion auf. Standardmäßig sind interne C-Laufzeitblöcke (_CRT_BLOCK) nicht in Speicherabbildvorgängen enthalten. Die _CrtSetDbgFlag Funktion kann zum Aktivieren des _CRTDBG_CHECK_CRT_DF Bits _crtDbgFlag verwendet werden, um diese Blöcke einzuschließen. Darüber hinaus sind Blöcke, die als freigegeben oder ignoriert gekennzeichnet sind (_FREE_BLOCK, _IGNORE_BLOCK) nicht im Speicherabbild enthalten.

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.

Anforderungen

Routine	Erforderlicher Header
_CrtMemDumpAll-ObjectsSince	<crtdbg.h>

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

Bibliotheken

Nur Debugversionen von C-Laufzeitbibliotheken

Beispiel

Ein Beispiel für die Verwendung _CrtMemDumpAllObjectsSincefinden Sie unter crt_dbg2.

Siehe auch

Debugroutinen
_crtDbgFlag