_CrtSetDumpClient
Installa una funzione definita dall'applicazione per eseguire il dump _CLIENT_BLOCK blocchi di memoria del tipo (versione di debug solo).
_CRT_DUMP_CLIENT _CrtSetDumpClient(
_CRT_DUMP_CLIENT dumpClient
);
Parametri
- dumpClient
Nuova funzione definita dal client del dump della memoria da associare nel processo del dump della memoria di debug di runtime del linguaggio C.
Valore restituito
Restituisce la funzione di dump client precedentemente definita del blocco.
Note
_CrtSetDumpClient la funzione consente di associare la propria funzione per eseguire il dump degli oggetti archiviati in _CLIENT_BLOCK blocchi di memoria nel processo del dump della memoria di debug di runtime del linguaggio C.Pertanto, ogni volta che una funzione di dump di debug come _CrtMemDumpAllObjectsSince o _CrtDumpMemoryLeaks esegue il dump di un oggetto _CLIENT_BLOCK il blocco di memoria, la funzione di dump dell'applicazione viene chiamato anche._CrtSetDumpClient fornisce una domanda con un metodo semplice per il rilevamento delle perdite di memoria e convalidare o generazione di report sul contenuto dei dati archiviati in _CLIENT_BLOCK blocchi.quando _DEBUG non è definito, le chiamate a _CrtSetDumpClient vengono ignorati durante la pre-elaborazione.
_CrtSetDumpClient la funzione di installare la nuova funzione di dump definita dall'applicazione specificata in dumpClient e restituisce la funzione di dump definiti in precedenza.Un esempio di funzione di dump di blocchi client è la seguente:
void DumpClientFunction( void *userPortion, size_t blockSize );
userPortion l'argomento è un puntatore all'inizio della parte di dati utente del blocco di memoria e blockSize specifica le dimensioni del blocco di memoria allocata in byte.La funzione di dump di blocchi client deve restituire void.Il puntatore alla funzione di dump client a cui viene passato _CrtSetDumpClient è di tipo _CRT_DUMP_CLIENT, come definito in Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Per un esempio di come implementare una funzione di dump definita dall'applicazione, vedere esempio crt_dbg2: Il runtime del linguaggio C debug delle funzioni hook.Per ulteriori informazioni sulle funzioni che operano su _CLIENT_BLOCK i blocchi di memoria del tipo, vedere Funzioni hook di blocchi client._CrtReportBlockType la funzione può essere utilizzata per restituire informazioni sui tipi di blocco e i sottotipi.
Requisiti
routine |
Intestazione di associazione |
|---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Per ulteriori informazioni sulla compatibilità, vedere compatibilità nell'introduzione.
Librerie
versioni di debug di Librerie di runtime del linguaggio C solo.
Esempio
Per un esempio di utilizzo _CrtSetDumpClient, vedere crt_dbg2.
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione c standard, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di pinvoke.