_CrtSetDumpClient
Installa una funzione definita dall'applicazione per eseguire il dump dei blocchi di memoria del tipo _CLIENT_BLOCK (solo versione di debug).
Sintassi
_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );
Parametri
dumpClient
Nuova funzione di dump della memoria definita dal client da associare.
Valore restituito
Restituisce la funzione del dump di blocco definita precedentemente dal client.
Osservazioni:
La _CrtSetDumpClient funzione consente all'applicazione di associare la propria funzione agli oggetti di dump archiviati in _CLIENT_BLOCK blocchi di memoria. Di conseguenza, ogni volta che una funzione di dump di debug, _CrtMemDumpAllObjectsSince ad esempio o _CrtDumpMemoryLeaks esegue il dump di un _CLIENT_BLOCK blocco di memoria, viene chiamata anche la funzione dump dell'applicazione. _CrtSetDumpClient fornisce un'applicazione con un metodo semplice di rilevamento delle perdite di memoria e di convalida o creazione di report del contenuto dei dati memorizzati in blocchi _CLIENT_BLOCK. Quando _DEBUG non è definito, le chiamate a _CrtSetDumpClient vengono rimosse durante la pre-elaborazione.
La funzione _CrtSetDumpClient installa la nuova funzione di dump definita dall'applicazione specificata in dumpClient e restituisce la funzione di dump precedentemente definita. Segue un esempio di funzione di dump di blocco client:
void DumpClientFunction( void *userPortion, size_t blockSize );
L'argomento userPortion è un puntatore all'inizio della parte di dati utente del blocco di memoria e blockSize specifica le dimensioni del blocco di memoria allocato in byte. La funzione di dump di blocco client deve restituire void. Il puntatore alla funzione di dump client passata a _CrtSetDumpClient è di tipo _CRT_DUMP_CLIENT, come definito in Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Per altre informazioni sulle funzioni che operano sui _CLIENT_BLOCK blocchi di memoria di tipo, vedere Funzioni hook dei blocchi client. La _CrtReportBlockType funzione può essere usata per restituire informazioni sui tipi di blocco e sui sottotipi.
Requisiti
| Ciclo | Intestazione obbligatoria |
|---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).
Librerie
Solo le versioni di debug delle librerie di runtime di C.