Partager via


_CrtSetDumpClient

Installe une fonction définie par l’application pour vider des blocs de mémoire de type _CLIENT_BLOCK (version de débogage uniquement).

Syntaxe

_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );

Paramètres

dumpClient
Nouvelle fonction de vidage de mémoire définie par le client à raccorder.

Valeur retournée

Retourne la fonction de vidage de bloc définie par le client.

Notes

La _CrtSetDumpClient fonction permet à l’application de raccorder sa propre fonction pour vider des objets stockés dans des _CLIENT_BLOCK blocs de mémoire. Par conséquent, chaque fois qu’une fonction de vidage de débogage, telle que _CrtMemDumpAllObjectsSince ou _CrtDumpMemoryLeaks vidage d’un _CLIENT_BLOCK bloc de mémoire, la fonction de vidage de l’application est également appelée. _CrtSetDumpClient fournit à une application une méthode simple pour détecter les fuites de mémoire et pour valider le contenu des données stockées dans des blocs _CLIENT_BLOCK ou pour créer des rapports à partir de ce contenu. Quand _DEBUG n’est pas défini, les appels à _CrtSetDumpClient sont supprimés lors du prétraitement.

La fonction _CrtSetDumpClient installe la nouvelle fonction de vidage définie par l’application spécifiée dans dumpClient et retourne la fonction de vidage définie. Voici un exemple de fonction de vidage de bloc client :

void DumpClientFunction( void *userPortion, size_t blockSize );

L’argument userPortion est un pointeur désignant le début de la partie des données utilisateur du bloc de mémoire et blockSize spécifie la taille du bloc de mémoire alloué en octets. La fonction de vidage de bloc client doit retourner void. Le pointeur désignant la fonction de vidage client passé à _CrtSetDumpClient est du type _CRT_DUMP_CLIENT, comme défini dans Crtdbg.h :

typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );

Pour plus d’informations sur les fonctions qui fonctionnent sur _CLIENT_BLOCK des blocs de mémoire de type, consultez fonctions de raccordement de bloc client. La _CrtReportBlockType fonction peut être utilisée pour retourner des informations sur les types de blocs et les sous-types.

Spécifications

Routine En-tête requis
_CrtSetDumpClient <crtdbg.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Uniquement les versions de débogage des bibliothèques Runtime C.

Voir aussi

Routines de débogage
_CrtReportBlockType
_CrtGetDumpClient