_CrtSetReportMode
Especifica el destino o destinos para un tipo específico del informe generado por _CrtDbgReport y cualquier macro que llamen _CrtDbgReport, _CrtDbgReportW, como _ASSERT, macros _ASSERTE, _ASSERT, macros _ASSERTE, _RPT, _RPTF, _RPTW, macros de _RPTFW, y _RPT, _RPTF, _RPTW, macros de _RPTFW (versión de depuración solo).
int _CrtSetReportMode(
int reportType,
int reportMode
);
Parámetros
reportType
Informe tipo: _CRT_WARN, _CRT_ERROR, y _CRT_ASSERT.reportMode
nuevos modo de informe o modos para reportType.
Valor devuelto
Cuando se complete correctamente, _CrtSetReportMode devuelve el modo de informe o los modos anteriores para el tipo de informe especificado en reportType.Si un valor no válido se pasa mientras que especifican reportType o un modo no válido para reportMode, _CrtSetReportMode invoca el controlador no válido del parámetro tal como se describe en Validación de parámetros.Si la ejecución puede continuar, conjuntos errno de esta función a EINVAL y devuelven -1.Para obtener más información, vea errno, _doserrno, _sys_errlist, y _sys_nerr.
Comentarios
_CrtSetReportMode especifica el destino de salida para _CrtDbgReport.Dado que las macros _ASSERT, _ASSERTE, _RPT, y llamada _CrtDbgReport, _CrtSetReportMode de _RPTF especifican el destino de salida de texto especificado con las macros.
Cuando _DEBUG no está definido, las llamadas a _CrtSetReportMode se quitan durante el preprocesamiento.
Si no llama _CrtSetReportMode para definir el destino de salida de mensajes, los valores predeterminados siguientes están activadas:
Dirigen a los errores de aserción y los errores en una ventana de mensajes de depuración.
Las advertencias de aplicaciones Windows se envían a la ventana de salida del depurador.
Las advertencias de aplicaciones de consola no se muestran.
La tabla siguiente se enumeran los tipos de informe definido en Crtdbg.h.
Tipo de informe |
Descripción |
|---|---|
_CRT_WARN |
Advertencias, mensajes, e información que no necesita la atención inmediata. |
_CRT_ERROR |
Errores, problemas irrecuperables, y problemas que requieren una atención inmediata. |
_CRT_ASSERT |
Errores de aserción (expresiones afirmadas que se evalúan como FALSE). |
La función de _CrtSetReportMode asigna el nuevo modo de informe especificado en reportMode al tipo de informe especificado en reportType y devuelve el modo de informe previamente definido para reportType.La tabla siguiente se enumeran las opciones disponibles para reportMode y el comportamiento resultante de _CrtDbgReport.Estas opciones se definen como el bit marca en Crtdbg.h.
modo de informe |
comportamiento de _CrtDbgReport |
|---|---|
_CRTDBG_MODE_DEBUG |
Escribe el mensaje en la ventana de salida del depurador. |
_CRTDBG_MODE_FILE |
Escribe el mensaje a un identificador de archivos tras._CrtSetReportFile se debe llamar a para definir el archivo concreto o secuencias para usar como destino. |
_CRTDBG_MODE_WNDW |
Crea un cuadro de mensaje para mostrar el mensaje junto con Abort, Retry, y los botones de Ignore . |
_CRTDBG_REPORT_MODE |
devuelve reportMode para reportTypeespecificado: 1 _CRTDBG_MODE_FILE 2 _CRTDBG_MODE_DEBUG 4 _CRTDBG_MODE_WNDW |
Cada tipo de informe puede designar mediante un, dos, o tres modos o modo sin en absoluto.Por consiguiente, es posible tener más de un destino definido para un único tipo de informe.Por ejemplo, el fragmento de código siguiente provoca errores de aserción enviarse a una ventana de mensajes de depuración y a stderr:
_CrtSetReportMode( _CRT_ASSERT, _CRTDBG_MODE_FILE | _CRTDBG_MODE_WNDW );
_CrtSetReportFile( _CRT_ASSERT, _CRTDBG_FILE_STDERR );
Además, el modo de informe o los modos para cada tipo de informe puede controlar por separado.Por ejemplo, es posible especificar que reportType de _CRT_WARN se envía a una cadena de depuración de salida, mientras que _CRT_ASSERT se muestra en una ventana de mensajes de depuración y se envía a stderr, como se muestra anteriormente.
Requisitos
rutina |
Encabezado necesario |
encabezado opcional |
|---|---|---|
_CrtSetReportMode |
<crtdbg.h> |
<errno.h> |
Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.
bibliotecas: Versiones de depuración de Características de la biblioteca CRT únicamente.
Ejemplo
Vea report.
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 Ejemplos de invocación de plataforma.