_CrtSetReportMode

  • Articolo

Specifica la destinazione o le destinazioni per un tipo di report specifico generato da _CrtDbgReport ed eventuali macro che chiamano _CrtDbgReport, _CrtDbgReportWad esempio_ASSERT , , _ASSERTE_ASSERT_EXPR macro e _RPT, _RPTF, _RPTW_RPTFW macro (solo versione di debug).

Sintassi

int _CrtSetReportMode(
   int reportType,
   int reportMode
);

Parametri

reportType
Tipo di segnalazione: _CRT_WARN, _CRT_ERROR e _CRT_ASSERT.

reportMode
Nuova modalità di report o modalità per reportType.

Valore restituito

Al termine, _CrtSetReportMode restituisce la precedente o le precedenti modalità di report per il tipo di report specificato in reportType. Se viene passato un valore non valido come reportType o viene specificata una modalità non valida per reportMode, _CrtSetReportMode richiama il gestore di parametri non validi come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione imposta errno suEINVAL e restituisce -1. Per altre informazioni, vedereerrno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

_CrtSetReportMode specifica la destinazione di output per _CrtDbgReport. Poiché le macro _ASSERT, _ASSERTE, _RPT, e _RPTF chiamano _CrtDbgReport, _CrtSetReportMode specifica la destinazione dell'output di testo determinato con queste macro.

Quando _DEBUG non è definito, le chiamate a _CrtSetReportMode vengono rimosse durante la pre-elaborazione.

Se non si chiama _CrtSetReportMode per definire la destinazione di output dei messaggi, vengono applicate le impostazioni predefinite seguenti:

  • Le asserzioni non riuscite e gli errori di asserzione vengono indirizzati a una finestra di messaggio di debug.

  • Gli avvisi da applicazioni di Windows vengono inviati alla finestra di output del debugger.

  • Gli avvisi delle applicazioni console non vengono visualizzati.

Nella tabella seguente sono elencati i tipi di report definiti in Crtdbg.h.

Tipo di report Descrizione
_CRT_WARN Avvisi, messaggi e informazioni che non richiedono attenzione immediata.
_CRT_ERROR Errori e problemi irreversibili che richiedono attenzione immediata.
_CRT_ASSERT Asserzioni non riuscite (espressioni dichiarate che restituiscono FALSE).

La funzione _CrtSetReportMode assegna la nuova modalità di report specificata in reportMode al tipo di report specificato in reportType e restituisce la modalità report definita in precedenza per reportType. La tabella seguente elenca le scelte disponibili per reportMode e il comportamento risultante di _CrtDbgReport. Queste opzioni sono definite flag di bit in Crtdbg.h.

Modalità rapporto Comportamento _CrtDbgReport
_CRTDBG_MODE_DEBUG Scrive il messaggio alla finestra di output del debugger.
_CRTDBG_MODE_FILE Scrive il messaggio a un handle di file specificato dall'utente. _CrtSetReportFile deve essere chiamato per definire il file o il flusso specifico da usare come destinazione.
_CRTDBG_MODE_WNDW Crea una finestra di messaggio per visualizzare il messaggio insieme ai pulsanti Interrompi, Riprova e Ignora .
_CRTDBG_REPORT_MODE Restituisce reportMode per il reportType specificato:

1 _CRTDBG_MODE_FILE

2 _CRTDBG_MODE_DEBUG

4 _CRTDBG_MODE_WNDW

Ogni tipo di report può essere riportato tramite uno, due o tre modalità oppure senza modalità. Pertanto, è possibile avere più di una destinazione definita per un singolo tipo di report. Ad esempio, il frammento di codice seguente causa errori di asserzione da essere inviati a una finestra di messaggio di debug e a stderr:

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

Inoltre, è possibile controllare separatamente la modalità di creazione di report o le modalità per ogni tipo di report. Ad esempio, è possibile specificare che un reportType di _CRT_WARN passa a una stringa di debug di output, mentre _CRT_ASSERT viene visualizzato usando una finestra del messaggio di debug e viene inviato a stderr, come illustrato in precedenza.

Requisiti

Ciclo Intestazione obbligatoria Intestazione facoltativa
_CrtSetReportMode <crtdbg.h> <errno.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie: esegue il debug solo delle versioni delle librerie di runtime C.

Vedi anche

Routine di debug