Fonctions de raccordement de rapport
Mise à jour : novembre 2007
Cette rubrique s'applique à :
Édition |
Visual Basic |
C# |
C++ |
Web Developer |
|---|---|---|---|---|
Express |
.gif) |
|
Natif uniquement |
|
Standard |
|
|
Natif uniquement |
|
Pro et Team |
|
|
Natif uniquement |
|
Légende du tableau :
.gif) |
Applicable |
|
Non applicable |
.gif) |
Commande ou commandes masquées par défaut. |
Une fonction de raccordement de rapport, installée avec _CrtSetReportHook, est appelée chaque fois que _CrtDbgReport génère un rapport de débogage. Vous pouvez vous en servir, entre autres, pour filtrer les rapports de façon à vous concentrer sur des types d'allocations spécifiques. Une fonction de raccordement de rapport doit avoir un prototype similaire au suivant :
int YourReportHook(int nRptType, char *szMsg, int *retVal);
Le pointeur que vous passez à _CrtSetReportHook est du type _CRT_REPORT_HOOK, comme cela est défini dans CRTDBG.H :
typedef int (__cdecl *_CRT_REPORT_HOOK)(int, char *, int *);
Lorsque la bibliothèque Runtime appelle votre fonction de raccordement, l'argument nRptType contient la catégorie du rapport (_CRT_WARN, _CRT_ERROR ou _CRT_ASSERT), szMsg contient un pointeur vers une chaîne de message de rapport entièrement assemblé et retVal spécifie si _CrtDbgReport doit poursuivre normalement son exécution après avoir généré le rapport ou démarrer le débogueur. (Si la valeur de retVal est zéro, l'exécution se poursuit, si cette valeur est 1, le débogueur est démarré.)
Si le raccordement gère intégralement le message concerné et qu'aucun rapport supplémentaire n'est requis, il devrait retourner la valeur TRUE. S'il retourne FALSE, _CrtDbgReport communiquera le message de la façon normale.
Voir aussi
Tâches
crt_dbg2, exemple : fonctions de raccordement du débogage du runtime C