_CrtSetReportHook2, _CrtSetReportHookW2

Article
03/04/2013

Installe ou désinstalle une fonction de rapport définie par le client en l'accrochant dans le processus de création de rapport de débogage runtime C (version debug uniquement).

int _CrtSetReportHook2(
   int mode,
   _CRT_REPORT_HOOK pfnNewHook
);
int _CrtSetReportHookW2(
   int mode,
   _CRT_REPORT_HOOKW pfnNewHook
);

Paramètres

mode
L'action à effectuer : _CRT_RPTHOOK_INSTALL ou _CRT_RPTHOOK_REMOVE.
pfnNewHook
enregistrez le raccordement pour installer ou supprimer dans la version d'étroit-personnage de cette fonction.
pfnNewHook
Enregistrez le raccordement pour installer ou supprimer dans la version à caractère élargi de cette fonction.

Valeur de retour

-1 si une erreur se produit, avec EINVAL ou ENOMEM définissez ; sinon retourne le décompte de références d' pfnNewHook après l'appel.

Notes

_CrtSetReportHook2 et _CrtSetReportHookW2vous permettent de connecter ou décrocher une fonction, alors que _CrtSetReportHook vous autorise uniquement raccorder une fonction.

_CrtSetReportHook2 ou _CrtSetReportHookW2doit être utilisé au lieu d' _CrtSetReportHook lorsque l'appel de raccordement s'effectue dans une DLL et lorsque les plusieurs DLL peuvent être chargés et exemple leurs propres fonctions de raccordement.Dans ce cas, les DLL peuvent être déchargés dans un ordre différent de celui dans lequel ils ont été chargés et la fonction de raccordement peut rester pointant vers une DLL déchargé.Toute sortie de débogage s'arrête le processus si les fonctions de raccordement était ajoutée à _CrtSetReportHook.

Toutes les fonctions de raccordement ajoutées avec _CrtSetReportHook sont appelées s'il n'existe aucune fonction de raccordement ajoutée à _CrtSetReportHook2 ou _CrtSetReportHookW2ou si toutes les fonctions de raccordement ajoutées avec _CrtSetReportHook2 et _CrtSetReportHookW2retournent FALSE.

La version à caractère élargi de cette fonction est disponible.Les fonctions de raccordement de rapport acceptant une chaîne dont le type (caractères ou étroits) doit correspondre à la version de cette fonction utilisée.Utilisez le prototype de fonction suivant pour les connexions d'état utilisés avec la version à caractère élargi de cette fonction :

int YourReportHook( int reportType, wchar_t *message, int *returnValue );

Utilisez le prototype suivant pour les connexions d'état d'étroit-personnage :

int YourReportHook( int reportType, char *message, int *returnValue );

ces fonctions valident leurs paramètres.si mode ou pfnNewNook est valide, ces fonctions appellent le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, ces errno défini par fonctions à EINVAL et à retourner -1.

[!REMARQUE]

Si votre application est compilée avec /clr et une fonctionnalité de création de rapports est appelée après que l'application soit arrêtée main, le CLR lèvera une exception si les appels de fonctions de création de rapports que tout fonctions CRT.

Configuration requise

routine	en-tête requis	en-tête facultatif
_CrtSetReportHook2	<crtdbg.h>	<errno.h>
_CrtSetReportHookW2	<crtdbg.h>	<errno.h>

Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.

bibliothèques

Versions debug de Bibliothèques runtime C uniquement.

Exemple

// crt_setreporthook2.c
#include <windows.h>
#include <stdio.h>
#include <crtdbg.h>
#include <assert.h>

int __cdecl TestHook1(int nReportType, char* szMsg, int* pnRet)
{
   int nRet = FALSE;

   printf("CRT report hook 1.\n");
   printf("CRT report type is \"");
   switch (nReportType)
   {
      case _CRT_ASSERT:
      {
         printf("_CRT_ASSERT");
         // nRet = TRUE;   // Always stop for this type of report
         break;
      }

      case _CRT_WARN:
      {
         printf("_CRT_WARN");
         break;
      }

      case _CRT_ERROR:
      {
         printf("_CRT_ERROR");
         break;
      }

      default:
      {
         printf("???Unknown???");
         break;
      }
   }

   printf("\".\nCRT report message is:\n\t");
   printf(szMsg);

   if   (pnRet)
      *pnRet = 0;

   return   nRet;
}

int __cdecl   TestHook2(int nReportType, char* szMsg, int* pnRet)
{
   int   nRet = FALSE;

   printf("CRT report hook 2.\n");
   printf("CRT report type is \"");
   switch   (nReportType)
   {
      case _CRT_WARN:
      {
         printf("_CRT_WARN");
         break;
      }

      case _CRT_ERROR:
      {
         printf("_CRT_ERROR");
         break;
      }

      case _CRT_ASSERT:
      {
         printf("_CRT_ASSERT");
         nRet = TRUE;   // Always stop for this type of report
         break;
      }

      default:
      {
         printf("???Unknown???");
         break;
      }
   }

   printf("\".\nCRT report message is: \t");
   printf(szMsg);

   if   (pnRet)
      *pnRet = 0;
   // printf("CRT report code is %d.\n", *pnRet);
   return   nRet;
}

int   main(int argc, char* argv[])
{
   int   nRet = 0;

   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook1);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook1)"
          " returned %d\n", nRet);
   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook2);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook2)"
          " returned %d\n", nRet);
   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook2);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook2)"
          " returned %d\n", nRet);
   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook1);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook1)"
          " returned %d\n", nRet);
   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook1);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook1)"
          " returned %d\n", nRet);

   _ASSERT(0);

   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2)"
          " returned %d\n", nRet);
   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2)"
          " returned %d\n", nRet);
   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2)"
          " returned %d\n", nRet);
   nRet = _CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook1);
   printf("_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook1)"
          " returned %d\n", nRet);

   return   nRet;
}

Sortie

_CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook1) returned 0
_CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook2) returned 0
_CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook2) returned 0
_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook1) returned 0
_CrtSetReportHook2(_CRT_RPTHOOK_INSTALL, TestHook1) returned 0
_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2) returned 0
_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2) returned 0
_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook2) returned 0
_CrtSetReportHook2(_CRT_RPTHOOK_REMOVE, TestHook1) returned 0

Voir aussi

Référence

Déboguez des routines

Partager via