_CrtMemCheckpoint
Ottiene lo stato corrente dell'heap di debug e gli archivi in applicazione-fornito _CrtMemState struttura (versione di debug solo).
void _CrtMemCheckpoint(
_CrtMemState *state
);
Parametri
- state
puntatore a _CrtMemState struttura per riempire di checkpoint di memoria.
Note
_CrtMemCheckpoint la funzione crea uno snapshot dello stato corrente dell'heap di debug in qualsiasi momento.Questo snapshot può essere utilizzato da altre funzioni dello stato dell'heap come _CrtMemCheckpoint per il rilevamento di perdite di memoria e altri problemi.quando _DEBUG non è definito, le chiamate a _CrtMemState vengono ignorati durante la pre-elaborazione.
L'applicazione deve passare un puntatore a un'istanza in precedenza allocata di _CrtMemState struttura, definita in Crtdbg.h, in state parametro.se _CrtMemCheckpoint si verifica un errore durante la creazione di checkpoint, la funzione genera un'eccezione _CRT_WARN report di debug che descrive il problema.
Per ulteriori informazioni sulle funzioni di stato dell'heap e _CrtMemState la struttura, vedere Funzioni per la creazione di rapporti sullo stato dello heap.Per ulteriori informazioni su come i blocchi di memoria vengono allocati, inizializzati e vengono gestiti nella versione di debug dell'heap di base, vedere Gestione della memoria e heap di debug.
se state viene NULL, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, errno, _doserrno, _sys_errlist e _sys_nerr è impostato su EINVAL e la funzione restituisce.
Requisiti
routine |
Intestazione di associazione |
|---|---|
_CrtMemCheckpoint |
<crtdbg.h> , <errno.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
raccolte: versioni di debug di Funzionalità della libreria CRT solo.
Esempio
Vedere crt_dbg1.
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione c standard, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di platform invoke.