_CrtSetReportHook

Instala uma função definida pelo cliente de relatório enganchando-lo para o C em time de execução depurar (somente versão de depurar) do processo de geração de relatórios.

_CRT_REPORT_HOOK _CrtSetReportHook( 
   _CRT_REPORT_HOOK reportHook 
);

Parâmetros

• reportHook
  Novo cliente-definido relatar função para capturar ao C em time de execução depurar processo de geração de relatórios.

Valor de retorno

Retorna o anterior relatar função definida pelo cliente.

Comentários

_CrtSetReportHook permite que um aplicativo usar sua própria função de relatório para o C biblioteca de time de execução depurar processo de geração de relatórios. sistema autônomo resultado, sempre que _CrtDbgReport é chamado para gerar um relatório de depurar, função de relatório do aplicativo é chamada pela primeira vez.Essa funcionalidade permite que um aplicativo executar operações sistema autônomo filtragem de relatórios de depurar então ele pode se concentrar em tipos de alocação específica ou enviar um relatório para destinos não está disponível usando _CrtDbgReport. Quando _DEBUG não estiver definido, chamadas de _CrtSetReportHook serão removidos durante a pré-processamento.

Para obter uma versão mais robusto _CrtSetReportHook, consulte _CrtSetReportHook2.

The _CrtSetReportHook função instala a nova função especificada na emissão de relatórios definidos pelo cliente reportHook e conectar retorna que anterior definido pelo cliente. O exemplo a seguir demonstra como um gancho de relatório definidos pelo cliente deve ser com protótipo:

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

em que reportType é o depurar relatório tipo (_CRT_WARN, _CRT_ERROR, ou _CRT_ASSERT), message é a mensagem de usuário de depurar totalmente montado estejam contidos no relatório, e returnValue o valor especificado pelo definido cliente está relatando que deve ser retornada pela função _CrtDbgReport. Para obter uma descrição completa dos tipos de relatório disponível, consulte o _CrtSetReportMode função.

Se a função de relatório definidos pelo cliente completamente manipula a mensagem de depurar que não é necessário nenhum relatório ainda mais, a função deve retornar TRUE. Quando a função retornará FALSE, _CrtDbgReport é chamado para gerar o relatório de depurar usando as configurações corrente para o tipo de relatório, o modo e o arquivo. Além disso, especificando o _CrtDbgReport valor retornado returnValue, o aplicativo também pode controlar se ocorre uma interrupção na depurar. Para obter uma descrição completa de como o relatório de depurar é gerado e configurado, consulte _CrtSetReportMode, _CrtSetReportFile, and _CrtDbgReport.

Para obter mais informações sobre como usar outros gancho com em time de execução funções e escrever suas próprias funções de gancho definido pelo cliente, consulte Escrevendo suas próprias funções de gancho de depurar.

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 a função de relatório chama as funções de CRT.

Requisitos

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

Bibliotecas

Versões de depurar de Bibliotecas de time de execução c somente.

Exemplo

Para obter um exemplo de como usar _CrtSetReportHook, consulte relatório.

Equivalente do NET Framework

Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Rotinas de depurar

_CrtGetReportHook