_CrtSetDumpClient
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