_RTC_SetErrorFuncW
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.
Libraries
Alle Versionen der C-Laufzeitbibliotheken.