Compartilhar via


Funções de gancho de relatório

Este tópico se aplica a:

Edição

Visual Basic

C#

C++

Desenvolvedores Web

Express

Somente nativo

Padrão

Somente nativo

PRO e equipe

Somente nativo

Legenda de tabela:

Aplica-se

Não é aplicada

Comando ou comandos oculta por padrão.

Uma função de gancho de relatório, instalada usando _CrtSetReportHook, é chamado de cada vez _CrtDbgReport gera um relatório de depurar.Você pode usá-lo, entre outras coisas, para relatórios de filtragem para se concentrar em tipos específicos de alocações.Uma função de gancho de relatório deve ter um protótipo semelhante ao seguinte:

int YourReportHook(int nRptType, char *szMsg, int *retVal);

O ponteiro passar para _CrtSetReportHook é do tipo _CRT_REPORT_HOOK, conforme definido no CRTDBG.H:

typedef int (__cdecl *_CRT_REPORT_HOOK)(int, char *, int *);

Quando a biblioteca de time de execução chama sua função de gancho, o nRptType argumento contiver a categoria do relatório (_CRT_WARN, _CRT_ERROR, or _CRT_ASSERT), szMsg contém um ponteiro para uma seqüência de mensagem de relatório totalmente montado e retVal Especifica se _CrtDbgReport deve continuar a execução normal após gerar o relatório ou inicie o depurador. (A retVal valor zero continua a execução, o valor de 1 inicia o depurador.)

Se o gancho manipula a mensagem em questão completamente, para que nenhum relatório mais seja necessária, ele deverá retornar TRUE.Se ela retorna FALSE, _CrtDbgReport irá relatar a mensagem normalmente.

Consulte também

Tarefas

Exemplo de crt_dbg2: C Run-Time Depurando gancho funções

Outros recursos

Texto de função de gancho de depurar