Fonction SetupWriteTextLogInfLine (setupapi.h)

Article
03/04/2024

La fonction SetupWriteTextLogInfLine écrit une entrée de journal dans un journal de texte SetupAPI qui contient le texte d’une ligne de fichier INF spécifiée.

Syntaxe

WINSETUPAPI VOID SetupWriteTextLogInfLine(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Flags,
  [in] HINF         InfHandle,
  [in] PINFCONTEXT  Context
);

Paramètres

[in] LogToken

Jeton de journal qui est un jeton de journal défini par le système ou qui a été retourné par SetupGetThreadLogToken.

[in] Flags

Valeur de type DWORD qui est un or au niveau du bit des valeurs d’indicateur, qui spécifient les éléments suivants :

Niveau d’événement de l’entrée de journal. Les niveaux d’événements qui peuvent être spécifiés pour une entrée de journal sont les mêmes que ceux qui peuvent être activés pour un journal texte. Pour obtenir la liste des indicateurs de niveau événement, consultez Définition du niveau d’événement pour un journal de texte SetupAPI.
Indique s’il faut inclure un horodatage dans l’entrée du journal. La valeur de l’indicateur d’horodatage est TXTLOG_TIMESTAMP.
Modification, le cas échéant, de la profondeur de mise en retrait de la section et de l’entrée de journal actuelle. Pour plus d’informations sur l’utilisation des indicateurs de retrait, consultez Écriture d’entrées de journal mises en retrait.

[in] InfHandle

Handle du fichier INF qui inclut la ligne de texte à écrire dans le journal de texte. Un handle dans un fichier INF est obtenu en appelant SetupOpenInfFile, qui est documenté dans le Kit de développement logiciel (SDK) de plateforme.

[in] Context

Pointeur vers un contexte de fichier INF qui spécifie la ligne de texte à écrire dans le journal de texte. Un contexte de fichier INF pour une ligne est obtenu en appelant les fonctions SetupFindXxxLine . Pour plus d’informations sur les fichiers INF et un contexte de fichier INF, consultez les informations fournies dans le Kit de développement logiciel (SDK) de plateforme sur l’utilisation des fichiers INF, l’obtention d’un contexte de fichier INF et la structure INFCONTEXT.

Valeur de retour

None

Remarques

SetupWriteTextLogInfLine écrit une entrée de journal au format suivant :

entrée-préfixehorodatageinf :retraitinf-line-text(inf-file-nameligneline-number)

Où :

Les champs préfixe d’entrée et horodatage sont identiques à ceux décrits dans Format d’un corps de section de journal de texte.
Le champ inf-line-text contient le texte de la ligne de fichier INF spécifiée.
Le champ inf-file-name contient le nom du fichier INF qui contient la ligne de fichier INF spécifiée.
Le champ numéro de ligne contient le numéro de ligne de la ligne spécifiée dans le fichier INF.

Le jeton de journal et les indicateurs qu’un appelant fournit affectent le fonctionnement de SetupWriteTextLogInfLine de la même manière que celle décrite pour SetupWriteTextLog et SetupWriteTextLogError. En outre, SetupWriteTextLogInfLine utilise la catégorie d’événement TXTLOG_INF.

Pour obtenir des informations générales sur l’écriture d’entrées de journal dans les journaux de texte SetupAPI, consultez Journalisation SetupAPI (Windows Vista).

Pour plus d’informations sur le fonctionnement de SetupWriteTextLogInfLine, consultez Appel de SetupWriteTextLogInfLine.

Pour plus d’informations sur les différents types de jetons de journal, consultez Jetons de journal.

Pour plus d’informations sur l’utilisation des jetons de journal, consultez Définition et obtention d’un jeton de journal pour un thread.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions plus récentes de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

SetupGetThreadLogToken

SetupWriteTextLog

SetupWriteTextLogError

Partager via