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

Vedi anche

Routine di debug
_CrtReportBlockType
_CrtGetDumpClient