_CrtMemCheckpoint

Ottiene lo stato corrente dell'heap di debug e lo memorizza in una struttura _CrtMemState fornita dall'applicazione (solo versione debug).

Sintassi

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Parametri

state
Puntatore alla struttura _CrtMemState da riempire con il checkpoint di memoria.

Osservazioni:

La funzione _CrtMemCheckpoint crea uno snapshot dello stato corrente dell'heap di debug in qualsiasi momento. Questo snapshot può essere usato da altre funzioni di stato dell'heap, _CrtMemDifference ad esempio per rilevare perdite di memoria e altri problemi. Quando _DEBUG non è definito, le chiamate a _CrtMemState vengono rimosse durante la pre-elaborazione.

L'applicazione deve passare un puntatore a un'istanza precedentemente allocata della struttura _CrtMemState , definita in Crtdbg.h, nel parametro state . Se _CrtMemCheckpoint incontra un errore durante la creazione del checkpoint, la funzione genera un report di debug _CRT_WARN che descrive il problema.

Per altre informazioni sulle funzioni di stato dell'heap e sulla _CrtMemState struttura, vedere Funzioni di creazione di report dello stato heap. Per altre informazioni sulla modalità di allocazione, inizializzazione e gestione dei blocchi di memoria nella versione di debug dell'heap di base, vedere Dettagli dell'heap di debug CRT.

Se state è NULL, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno, _doserrno_sys_errlist, e _sys_nerr è impostata su EINVAL e la funzione restituisce .

Requisiti

Ciclo	Intestazione obbligatoria
_CrtMemCheckpoint	<crtdbg.h>, <errno.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie: solo versioni di debug di UCRT.

Vedi anche

Routine di debug
_CrtMemDifference