_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.