`_CrtSetReportMode`

Articolo
04/03/2023

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

Condividi tramite