_CrtSetReportHook2, _CrtSetReportHookW2

Artigo
02/25/2013

Instala ou desinstala uma função definida pelo cliente de relatório por conectá-lo para a depuração de tempo de execução C (somente a versão de depuração) do processo de emissão de relatórios.

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

Parâmetros

mode
A ação a seguir: _CRT_RPTHOOK_INSTALL ou _CRT_RPTHOOK_REMOVE.
pfnNewHook
Gancho de relatório para instalar ou remover na versão caracteres estreitos desta função.
pfnNewHook
Gancho de relatório para instalar ou remover a versão de caractere largo desta função.

Valor de retorno

-1 se ocorreu um erro, com EINVAL ou ENOMEM definido; Caso contrário, retorna a contagem de referência de pfnNewHook após a chamada.

Comentários

_CrtSetReportHook2e _CrtSetReportHookW2 permitem que você conectar ou desencaixe uma função, enquanto _CrtSetReportHook somente permite que você conectar uma função.

_CrtSetReportHook2ou _CrtSetReportHookW2 deve ser usado em vez de _CrtSetReportHook quando a chamada do gancho é feita em uma DLL e quando várias DLLs podem ser carregadas e definir suas próprias funções de gancho.Em tal situação, DLLs podem ser descarregadas em uma ordem diferente, que foram carregados e a função de gancho pode ser deixada apontando para uma DLL descarregada.O processo de travamento de qualquer saída de depuração se as funções de gancho foram adicionadas com _CrtSetReportHook.

Qualquer um gancho funções adicionadas com _CrtSetReportHook chamam-se não houver nenhum gancho funções adicionadas com _CrtSetReportHook2 ou _CrtSetReportHookW2 ou se capturar a todas as funções adicionadas com _CrtSetReportHook2 e _CrtSetReportHookW2 retornar FALSE.

A versão de caractere largo desta função está disponível.As funções de gancho de relatório sejam uma cadeia de caracteres cujo tipo (caracteres larga ou estreitas) deve corresponder à versão desta função usada.Use o seguinte protótipo de função para os ganchos de relatório usados com a versão de caractere largo desta função:

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

Use o seguinte protótipo para os ganchos do relatório de estreito caracteres:

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

Essas funções validam seus parâmetros.Se mode ou pfnNewNook é inválido, essas funções chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essas funções definir errno para EINVAL e retornar -1.

Observação
Se seu aplicativo é compilado com /clr e a função de relatório é chamada após o aplicativo foi encerrado principal, o CLR lançará uma exceção se quaisquer funções de CRT de chama a função de relatório.

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_CrtSetReportHook2	<crtdbg.h>	<errno.h>
_CrtSetReportHookW2	<crtdbg.h>	<errno.h>

Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.

Bibliotecas

Versões de depuração de bibliotecas de tempo de execução c somente.

Exemplo

// 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;
}

Saída

_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

Consulte também

Referência

Rotinas de depuração

Compartilhar via