`_RTC_SetErrorFuncW`

Artikel
10/12/2023

Legt eine Funktion als den Handler für das Melden von Fehlern der Fehlerprüfung zur Laufzeit (RTCs) fest.

Syntax

_RTC_error_fnW _RTC_SetErrorFuncW(
   _RTC_error_fnW function
);

Parameter

function
Die Adresse der Funktion, die Fehlerprüfungen zur Laufzeit verarbeitet.

Rückgabewert

Die zuvor definierte Fehlerfunktion; oder NULL wenn keine zuvor definierte Funktion vorhanden ist.

Hinweise

Verwenden Sie in neuem Code ausschließlich _RTC_SetErrorFuncW. _RTC_SetErrorFunc ist in der Bibliothek nur noch aus Gründen der Abwärtskompatibilität enthalten.

Der Rückruf _RTC_SetErrorFuncW gilt nur für die Komponente, für die er eingebunden wurde, aber nicht global.

Stellen Sie sicher, dass die Adresse, die Sie an _RTC_SetErrorFuncW übergeben, zu einer gültigen Fehlerbehandlungsfunktion gehört.

Wenn einem Fehler mithilfe eines Typs von -1 _RTC_SetErrorTypeein Fehler zugewiesen wurde, wird die Fehlerbehandlungsfunktion nicht aufgerufen.

Bevor Sie diese Funktion aufrufen können, müssen Sie zuerst eine der Initialisierungsfunktionen der Laufzeitfehlerüberprüfung aufrufen. Weitere Informationen finden Sie unter Verwenden von Laufzeitüberprüfungen ohne die C-Laufzeitbibliothek.

_RTC_error_fnW ist wie folgt definiert:

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

Dabei gilt Folgendes:

errorType
Der Fehlertyp, der von _RTC_SetErrorType.

filename
Die Quelldatei, in der der Fehler aufgetreten ist oder null, wenn keine Debuginformationen verfügbar sind.

linenumber
Die Zeile, in filename der der Fehler aufgetreten ist, oder 0, wenn keine Debuginformationen verfügbar sind.

moduleName
Die DLL oder Name des ausführbaren Programms, wo der Fehler aufgetreten ist.

format
printf-Formatzeichenfolge, um eine Fehlermeldung mit den übrigen Parameter anzuzeigen. Das erste Argument ist VA_ARGLIST die RTC-Fehlernummer, die aufgetreten ist.

Ein Beispiel zur Verwendung _RTC_error_fnWfinden Sie unter Anpassung der systemeigenen Laufzeitüberprüfungen.

Anforderungen

Routine	Erforderlicher Header
`_RTC_SetErrorFuncW`	<rtcapi.h>

Weitere Informationen finden Sie unter Kompatibilität.

Bibliotheken

Alle Versionen der C-Laufzeitbibliotheken.

Siehe auch

_CrtDbgReport, _CrtDbgReportW
Laufzeitfehlerüberprüfung