Funções de gancho de relatório
This topic applies to:
Edition |
Visual Basic |
C# |
F# |
C++ |
Web Developer |
|---|---|---|---|---|---|
Express |
.gif "O tópico não é aplicável") |
|
|
Native only |
|
Pro, Premium e Ultimate |
|
|
|
Native only |
|
Uma função de gancho de relatório, instalada usando _CrtSetReportHook, é chamado sempre _CrtDbgReport gera um relatório de depuração. 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 que você passar para _CrtSetReportHook é do tipo _CRT_REPORT_HOOK, conforme definido em CRTDBG.H:
typedef int (__cdecl *_CRT_REPORT_HOOK)(int, char *, int *);
Quando a biblioteca de tempo de execução chama sua função de gancho, o nRptType argumento contém a categoria do relatório (_CRT_WARN, _CRT_ERROR, ou _CRT_ASSERT), szMsg contém um ponteiro para uma seqüência de mensagem de relatório totalmente montados e retVal Especifica se _CrtDbgReport deve continuar a execução normal após gerar o relatório ou iniciar o depurador. (A retVal o valor zero continua a execução, um valor de 1 inicia o depurador.)
Se o gancho trata a mensagem em questão completamente, de modo que nenhum relatório adicional é necessária, ele deverá retornar TRUE. Se ela retorna FALSE, _CrtDbgReport reportará a mensagem normalmente.
Consulte também
Tarefas
Exemplo de crt_dbg2: Funções de gancho de depuração c Run-Time.