_CrtSetReportHook
Instalar una función definido por cliente de informe enlazandola en el proceso de informe de depuración en tiempo de ejecución de C (versión de depuración solo).
_CRT_REPORT_HOOK _CrtSetReportHook(
_CRT_REPORT_HOOK reportHook
);
Parámetros
- reportHook
Nueva función definido por cliente de informe el enlace en el proceso de informe de depuración en tiempo de ejecución de C.
Valor devuelto
Devuelve la función definido por cliente anterior de informes.
Comentarios
_CrtSetReportHook permite que una aplicación para utilizar su propia función de informe en el proceso de informe de la biblioteca de depuración en tiempo de ejecución de C.Como resultado, siempre que _CrtDbgReport se denomina para generar un informe de depuración, la función informes de la aplicación se denomina primero.Esta funcionalidad permite a una aplicación para realizar operaciones como informes de depuración de filtrado para que pueda centrarse en determinados tipos de asignación o enviar un informe a los destinos no disponible mediante _CrtDbgReport.Cuando _DEBUG no está definido, las llamadas a _CrtSetReportHook se quitan durante el preprocesamiento.
Para una versión más sólida de _CrtSetReportHook, vea _CrtSetReportHook2.
La función de _CrtSetReportHook instala la nueva función definido por cliente de informes especificada en reportHook y devuelve el enlace definido por cliente anterior.El ejemplo siguiente muestra cómo un enlace definido por cliente de informe debe ser prototipado:
int YourReportHook( int reportType, char *message, int *returnValue );
donde es el tipo reportType de informe de depuración (_CRT_WARN, _CRT_ERROR, o _CRT_ASSERT), message es el mensaje totalmente ensamblado de usuario de depuración que se incluirá en el informe, y returnValue es el valor especificado por la función definido por cliente del informe que se debe devolver por _CrtDbgReport.Para obtener una descripción completa de los tipos disponibles de informe, vea la función de _CrtSetReportMode .
Si la función definido por cliente de informes controla completamente el mensaje de depuración para que no se requiere ningún otro informe de errores, la función debe devolver TRUE.Cuando la función devuelve FALSE, _CrtDbgReport se llama para generar el informe de depuración mediante la configuración actual para el tipo, el modo, y el archivo de informe.Además, especificando el valor devuelto de _CrtDbgReport en returnValue, la aplicación también puede controlar si una interrupción de depuración aparece.Para obtener una descripción completa de cómo se configura y se genera el informe de depuración, vea _CrtSetReportMode, _CrtSetReportFile, y _CrtDbgReport.
Para obtener más información sobre cómo usar otras funciones enlace-capaces en tiempo de ejecución y escritura para formar funciones definido por cliente de enlace, vea Escritura de las propias funciones de enlace de depuración.
[!NOTA]
Si la aplicación está compilada con /clr y se llama a la función de informe después de que la aplicación haya main salida, CLR producirá una excepción si funcionan las llamadas de función de informes cualquier CRT.
Requisitos
rutina |
Encabezado necesario |
|---|---|
_CrtSetReportHook |
<crtdbg.h> |
Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.
bibliotecas
Versiones de depuración de Bibliotecas en tiempo de ejecución de C únicamente.
Ejemplo
Para obtener un ejemplo de cómo utilizar _CrtSetReportHook, vea informe.
Equivalente en .NET Framework
No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.