_CrtSetReportMode

Spécifie la destination ou les destinations pour un type spécifique de rapport généré par _CrtDbgReport et toutes les macros qui appellent _CrtDbgReport, _CrtDbgReportW, _ASSERT, _ASSERTE, macros, _ASSERT, _ASSERTE, macros, _RPT, _RPTF, _RPTW, _RPTFW, macros, et _RPT, _RPTF, _RPTW, _RPTFW, macros (version Debug uniquement).

int _CrtSetReportMode( 
   int reportType,
   int reportMode 
);

Paramètres

• reportType
  Type de rapport: _CRT_WARN, _CRT_ERROR, et _CRT_ASSERT.

• reportMode
  Nouveaux mode de Rapport ou modes pour reportType.

Valeur de retour

Dans l'achèvement réussi, _CrtSetReportMode renvoie le mode Rapport ou les modes précédents pour le type de rapport spécifié dans reportType. Si une valeur valide est passée comme mode reportType ou non valide est spécifié pour reportMode, _CrtSetReportMode appelle le gestionnaire de paramètre non valide comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction définit errno à EINVAL et retourne -1. Pour plus d'informations, consultez errno, _doserrno, _sys_errlist et _sys_nerr.

Notes

_CrtSetReportMode spécifie la destination de sortie pour _CrtDbgReport. Les macros _ASSERT, _ASSERTE, _RPT, et _RPTF appellant _CrtDbgReport, _CrtSetReportMode spécifie la destination de sortie de texte spécifiée avec ces macros.

Lorsque _DEBUG n'est pas défini, les appels à _CrtSetReportMode sont supprimés pendant le prétraitement.

Si vous n'appelez pas _CrtSetReportMode pour définir la destination de sortie des messages, les valeurs par défaut suivantes sont activées :

• Les échecs Assert et les erreurs sont dirigées vers une fenêtre de message de débogage.

• Les avertissements d'applications Windows sont envoyés à la fenêtre Sortie du débogueur.

• Les avertissements des applications console ne sont pas affichés.

Le tableau suivant répertorie les types de rapports définis dans Crtdbg.h.

La fonction _CrtSetReportMode assigne le nouveau mode Rapport spécifié dans reportMode au type de rapport spécifié dans reportType et renvoie le mode Rapport précédemment défini pour reportType. Le tableau suivant répertorie les options disponibles pour reportMode et le comportement résultant de _CrtDbgReport. Ces options sont définies comme bits indicateurs dans Crtdbg.h.

Chaque type de rapport peut être enregistré avec un, deux, ou trois modes ou aucun mode. Par conséquent, il est possible d'avoir plusieurs destination définie pour un seul type de rapport. Par exemple, le fragment de code suivant provoque des échecs d'assertion à être envoyés vers une fenêtre de message de débogage et à stderr:

_CrtSetReportMode( _CRT_ASSERT, _CRTDBG_MODE_FILE | _CRTDBG_MODE_WNDW );
_CrtSetReportFile( _CRT_ASSERT, _CRTDBG_FILE_STDERR );

En outre, le mode de création de rapport ou les modes pour chaque type de rapport peuvent être séparément contrôlés. Par exemple, il est possible de spécifier que reportType de _CRT_WARN soit envoyé dans une chaîne de sortie de débogage, tandis que _CRT_ASSERT soit affiché dans une fenêtre de message de débogage et envoyé à stderr, comme illustré précédemment.

Configuration requise

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Bibliothèques : Versions Debug de Fonctions des bibliothèque CRT uniquement.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de code non managé.

Voir aussi

Référence

Routines de débogage