Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Installiert eine anwendungsdefinierte Funktion, zum Ausgeben von _CLIENT_BLOCK-Typspeicherblöcken (nur Debugversion).
Syntax
_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );
Parameter
dumpClient
Neue clientdefinierte Speicherabbildfunktion zum Hook.
Rückgabewert
Gibt die zuvor definierte Client-Blockdumpfunktion zurück.
Hinweise
Die _CrtSetDumpClient Funktion ermöglicht es der Anwendung, eine eigene Funktion zum Abbilden von Objekten zu verbinden, die in _CLIENT_BLOCK Speicherblöcken gespeichert sind. Daher wird jedes Mal, wenn eine Debugabbildfunktion wie _CrtMemDumpAllObjectsSince z _CrtDumpMemoryLeaks . B. einen _CLIENT_BLOCK Speicherblock abbildet, auch die Dumpfunktion der Anwendung aufgerufen. _CrtSetDumpClient stellt für eine Anwendung eine einfache Methode zum Erkennen von Speicherverlusten und zum Überprüfen oder Übermitteln des Inhalts der Daten bereit, die in _CLIENT_BLOCK-Blöcken gespeichert sind. Wenn _DEBUG nicht definiert ist, werden Aufrufe von _CrtSetDumpClient während der Vorverarbeitung entfernt.
Die _CrtSetDumpClient-Funktion installiert die neue anwendungsdefinierte Dumpfunktion, die in dumpClient angegeben ist, und gibt die zuvor definierte Dumpfunktion zurück. Beispiel einer Client-Blockdumpfunktion:
void DumpClientFunction( void *userPortion, size_t blockSize );
Das userPortion-Argument ist ein Zeiger auf den Anfang des Benutzerdatenteils des Speicherblocks, und blockSize gibt die Größe des belegten Speicherblocks in Bytes an. Die Client-Blockdumpfunktion muss void zurückgeben. Der Zeiger zur Clientdumpfunktion, der an _CrtSetDumpClient übergeben wird, ist vom Typ _CRT_DUMP_CLIENT, wie in "Crtdbg.h" definiert:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Weitere Informationen zu Funktionen, die auf _CLIENT_BLOCK Typspeicherblöcken arbeiten, finden Sie unter Clientblock-Hook-Funktionen. Die _CrtReportBlockType Funktion kann verwendet werden, um Informationen zu Blocktypen und Untertypen zurückzugeben.
Anforderungen
| Routine | Erforderlicher Header |
|---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Libraries
Nur Debugversionen von C-Laufzeitbibliotheken