_CrtSetReportHook
Instala 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.
_CRT_REPORT_HOOK _CrtSetReportHook(
_CRT_REPORT_HOOK reportHook
);
Parâmetros
- reportHook
Função relatórios nova definida pelo cliente para capturar ao tempo de execução c depurar o processo de emissão.
Valor de retorno
Retorna o anterior reporting função definida pelo cliente.
Comentários
_CrtSetReportHookpermite que um aplicativo para usar sua própria função de relatório para o c biblioteca de tempo de execução de depuração processo de emissão de relatórios.Como resultado, sempre que _CrtDbgReport é chamado para gerar um relatório de depuração, o aplicativo do relatório de função é chamada pela primeira vez.Essa funcionalidade permite que um aplicativo para executar operações como, por exemplo, filtrando relatórios de depuração, então ele pode se concentrar em tipos de alocação específica ou enviar um relatório para destinos não está disponíveis por meio de _CrtDbgReport.Quando _ Debug não está definido, planos de _CrtSetReportHook são removidos durante o pré-processamento.
Para obter uma versão mais robusta _CrtSetReportHook, consulte _CrtSetReportHook2.
O _CrtSetReportHook função instala a nova função especificada na emissão de relatórios definidos pelo cliente reportHook e retorna o gancho do cliente definido anterior.O exemplo a seguir demonstra como um gancho de relatório definidos pelo cliente deve ter como protótipo:
int YourReportHook( int reportType, char *message, int *returnValue );
onde reportType é o tipo de relatório de depuração (_CRT_WARN, _CRT_ERROR, ou _CRT_ASSERT), message é a mensagem do usuário de depuração totalmente montado estejam contidos no relatório, e returnValue o valor especificado pela definidos pelo cliente relata que deve ser retornada pela função _CrtDbgReport.Para obter uma descrição completa dos tipos de relatório disponíveis, consulte o _ CrtSetReportMode função.
Se a função de geração de relatórios definidos pelo cliente completamente manipular a mensagem de depuração de modo que nenhum relatório adicional é necessária, a função deve retornar TRUE.Quando a função retornará FALSE, _CrtDbgReport é chamado para gerar o relatório de depuração usando as configurações atuais para o tipo de relatório, o modo e o arquivo.Além disso, especificando a _CrtDbgReport retornar o valor em returnValue, o aplicativo também pode controlar se ocorrer uma quebra de depuração.Para obter uma descrição completa de como o relatório de depuração é configurado e gerado, consulte _CrtSetReportMode, _CrtSetReportFile, e _CrtDbgReport.
Para obter mais informações sobre como usar outras funções de tempo de execução compatível com gancho e escrever sua própria definição de cliente conectar funções, consulte Escrever seu próprio Debug gancho funções.
.gif "Observação") 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 |
|---|---|
_CrtSetReportHook |
<crtdbg.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
Para obter um exemplo de como usar _CrtSetReportHook, consulte relatório de.
Equivalência do .NET Framework
Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.