_CrtMemCheckpoint

Získá aktuální stav haldy ladění a ukládá do struktury dodané _CrtMemState aplikací (pouze ladicí verze).

Syntaxe

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Parametry

state
Ukazatel na _CrtMemState strukturu pro vyplnění kontrolního bodu paměti.

Poznámky

Funkce _CrtMemCheckpoint v libovolném okamžiku vytvoří snímek aktuálního stavu haldy ladění. Tento snímek může používat jiné funkce stavu haldy, jako _CrtMemDifference je například pomoc při zjišťování nevracení paměti a jiných problémů. Pokud _DEBUG není definováno, volání, která _CrtMemState se mají odebrat během předběžného zpracování.

Aplikace musí předat ukazatel na dříve přidělenou instanci _CrtMemState struktury definované v Crtdbg.h v parametru state . Pokud _CrtMemCheckpoint při vytváření kontrolního bodu dojde k chybě, funkce vygeneruje sestavu _CRT_WARN ladění popisující problém.

Další informace o funkcích stavu haldy a _CrtMemState struktuře naleznete v tématu Funkce generování sestav stavu haldy. Další informace o přidělování, inicializaci a správě bloků paměti ve verzi ladění základní haldy naleznete v podrobnostech haldy ladění CRT.

Pokud state je NULL, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, , errno, _doserrno_sys_errlista je nastavena na _sys_nerrEINVAL a funkce vrátí.

Požadavky

Rutina	Požadovaný hlavičkový soubor
_CrtMemCheckpoint	<crtdbg.h>, <errno.h>

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

Knihovny: Pouze ladicí verze UCRT.

Viz také

Rutiny ladění
_CrtMemDifference