IStillImageW ::WriteToErrorLog, méthode (sti.h)

Article
02/07/2025

La méthode IStillImage ::WriteToErrorLog écrit un message dans le journal des erreurs de l’image.

Syntaxe

HRESULT WriteToErrorLog(
       DWORD   dwMessageType,
  [in] LPCWSTR pszMessage
);

Paramètres

dwMessageType

Valeur constante fournie par l’appelant représentant le type de message. Les valeurs suivantes sont définies dans Sti.h:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

[in] pszMessage

Pointeur fourni par l’appelant vers la chaîne de message à écrire dans le fichier journal.

Valeur de retour

Si l’opération réussit, la méthode retourne S_OK. Sinon, elle retourne l’un des codes d’erreur préfixés STIERR définis dans stierr.h.

Remarques

Le fichier journal des erreurs d’image est nommé sti_trace.log et se trouve dans le répertoire Windows. Les valeurs de Registre déterminent quels types d’erreurs d’image (informations, avertissement ou erreur) sont écrits dans le journal des erreurs (voir Entrées de Registre non modifiables).

Les messages d’erreur doivent être réservés aux conditions d’erreur critiques, telles que les défaillances matérielles de l’appareil. Les messages d’information peuvent être utilisés à des fins de débogage. Les messages enregistrés ne sont pas visibles par les utilisateurs, mais ils peuvent être utilisés par un ingénieur du support technique pour aider à déboguer les problèmes d’un utilisateur.

Avant d’appeler IStillImage ::WriteToErrorLog, les clients de l’interface IStillImage COM doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	sti.h (include Sti.h)

Partager via