`_RTC_SetErrorFuncW`

Articolo
10/12/2023

Definisce una funzione come gestore per la segnalazione dei controlli degli errori di runtime (RTC).

Sintassi

_RTC_error_fnW _RTC_SetErrorFuncW(
   _RTC_error_fnW function
);

Parametri

function
L'indirizzo della funzione che gestirà i controlli degli errori di runtime.

Valore restituito

Funzione di errore definita in precedenza; o NULL se non esiste alcuna funzione definita in precedenza.

Osservazioni:

Nel nuovo codice usare solo _RTC_SetErrorFuncW. _RTC_SetErrorFunc è incluso nella libreria solo per la compatibilità con le versioni precedenti.

Il callback di _RTC_SetErrorFuncW si applica solo al componente che è stato collegato, ma non globalmente.

Verificare che l'indirizzo passato a _RTC_SetErrorFuncW corrisponda a quello di una funzione di gestione degli errori valida.

Se a un errore è stato assegnato un tipo -1 tramite _RTC_SetErrorType, la funzione di gestione degli errori non viene chiamata.

Prima di chiamare questa funzione, è necessario chiamare una delle funzioni di inizializzazione dei controlli degli errori di run-time. Per altre informazioni, vedere Uso dei controlli di runtime senza la libreria di runtime C.

_RTC_error_fnW è definito come segue:

typedef int (__cdecl * _RTC_error_fnW)(
    int errorType,
    const wchar_t * filename,
    int linenumber,
    const wchar_t * moduleName,
    const wchar_t * format,
    ... );

dove:

errorType
Tipo di errore specificato da _RTC_SetErrorType.

filename
File di origine in cui si è verificato l'errore o Null se non sono disponibili informazioni di debug.

linenumber
Riga in filename cui si è verificato l'errore oppure 0 se non sono disponibili informazioni di debug.

moduleName
DLL o nome dell'eseguibile in cui si è verificato l'errore.

format
Stringa di tipo printf per visualizzare un messaggio di errore, usando i parametri rimanenti. Il primo argomento di VA_ARGLIST è il numero di errore RTC che si è verificato.

Per un esempio che mostra come usare _RTC_error_fnW, vedere Controllo di runtime nativo della personalizzazione.

Requisiti

Ciclo	Intestazione obbligatoria
`_RTC_SetErrorFuncW`	<rtcapi.h>

Per altre informazioni, vedere Compatibility.

Librerie

Tutte le versioni delle librerie di runtime C.

Vedi anche

_CrtDbgReport, _CrtDbgReportW
Controllo degli errori di runtime

Condividi tramite