_CrtSetDumpClient

Nainstaluje funkci definovanou aplikací na bloky paměti typu výpisu _CLIENT_BLOCK paměti (pouze ladicí verze).

Syntaxe

_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );

Parametry

dumpClient
Nová funkce výpisu paměti definovaná klientem pro připojení.

Vrácená hodnota

Vrátí dříve definovanou funkci výpisu stavu stavu bloku klienta.

Poznámky

Tato _CrtSetDumpClient funkce umožňuje aplikaci připojit vlastní funkci k výpisu objektů uložených v _CLIENT_BLOCK blocích paměti. V důsledku toho se volá také pokaždé, když funkce výpisu stavu ladění, například _CrtMemDumpAllObjectsSince nebo _CrtDumpMemoryLeaks vysadí _CLIENT_BLOCK blok paměti, volá se také funkce výpisu paměti aplikace. _CrtSetDumpClient poskytuje aplikaci snadnou metodu pro detekci nevracení paměti a ověřování nebo hlášení obsahu dat uložených v _CLIENT_BLOCK blocích. Pokud _DEBUG není definováno, volání, která _CrtSetDumpClient se mají odebrat během předběžného zpracování.

Funkce _CrtSetDumpClient nainstaluje novou funkci výpisu paměti definovanou aplikací a dumpClient vrátí dříve definovanou funkci výpisu paměti. Příklad funkce výpisu stavu stavu bloku klienta je následující:

void DumpClientFunction( void *userPortion, size_t blockSize );

Argument userPortion je ukazatel na začátek části datové části bloku paměti uživatele a blockSize určuje velikost přiděleného bloku paměti v bajtech. Funkce výpisu stavu paměti bloku klienta musí vrátit void. Ukazatel na funkci výpisu stavu klienta, která je předána _CrtSetDumpClient , je typu _CRT_DUMP_CLIENT, jak je definováno v Crtdbg.h:

typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );

Další informace o funkcích, které pracují s _CLIENT_BLOCK bloky paměti typu, naleznete v tématu Funkce háku bloku klienta. Funkci _CrtReportBlockType lze použít k vrácení informací o typech bloků a podtypech.

Požadavky

Rutina	Požadovaný hlavičkový soubor
_CrtSetDumpClient	<crtdbg.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Knihovny

Ladění pouze verzí knihoven runtime jazyka C.

Viz také

Rutiny ladění
_CrtReportBlockType
_CrtGetDumpClient