`_RTC_SetErrorFuncW`

Article
08/03/2024

Désigne une fonction comme gestionnaire pour signaler les vérifications d’erreurs au moment de l’exécution (RTC).

Syntaxe

_RTC_error_fnW _RTC_SetErrorFuncW(
   _RTC_error_fnW function
);

Paramètres

function
L’adresse de la fonction qui va gérer les vérifications d’erreurs au moment de l’exécution.

Valeur retournée

Fonction d’erreur définie précédemment ; ou NULL s’il n’existe aucune fonction définie précédemment.

Notes

Dans du nouveau code, utilisez seulement _RTC_SetErrorFuncW. _RTC_SetErrorFunc est inclus dans la bibliothèque seulement pour assurer la compatibilité descendante.

Le rappel _RTC_SetErrorFuncW s’applique uniquement au composant auquel il était lié, mais pas globalement.

Vérifiez que l’adresse que vous transmettez à _RTC_SetErrorFuncW est celle d’une fonction de gestion des erreurs valide.

Si une erreur a été affectée à un type -1 à l’aide _RTC_SetErrorTypede , la fonction de gestion des erreurs n’est pas appelée.

Avant d’appeler cette fonction, vous devez d’abord appeler une des fonctions d’initialisation de vérification d’erreurs au moment de l’exécution. Pour plus d’informations, consultez Utilisation des vérifications d’exécution sans la bibliothèque runtime C.

_RTC_error_fnW est défini comme suit :

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

où :

errorType
Type d’erreur spécifié par _RTC_SetErrorType.

filename
Le fichier source où la défaillance s’est produite, ou null si aucune information de débogage n’est disponible.

linenumber
Ligne dans filename laquelle l’échec s’est produit ou 0 si aucune information de débogage n’est disponible.

moduleName
Le fichier DLL ou le nom du fichier exécutable où la défaillance s’est produite.

format
chaîne de style printf pour afficher un message d’erreur, en utilisant les paramètres restants. Le premier argument du VA_ARGLIST fichier est le numéro d’erreur RTC qui s’est produit.

Pour obtenir un exemple montrant comment utiliser _RTC_error_fnW, consultez la personnalisation des vérifications du runtime natif.

Spécifications

Routine	En-tête requis
`_RTC_SetErrorFuncW`	<rtcapi.h>

Pour plus d'informations, voir Compatibilité.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Voir aussi

_CrtDbgReport, _CrtDbgReportW
Vérification des erreurs d’exécution

Partager via