Partager via

Écriture d’une entrée de journal d’informations

  • Article

L’exemple suivant montre comment une application peut généralement appeler SetupWriteTextLog pour écrire une entrée d’informations dans un journal texte SetupAPI qui n’est pas un message d’avertissement ou un message d’erreur.

Pour plus d’informations sur l’appel de SetupWriteTextLog pour enregistrer un message d’erreur, consultez Calling SetupWriteTextLog to Log an Error or Warning Entry.

L’application appelle SetupWriteTextLog, en fournissant les valeurs de paramètre suivantes :

  • LogToken est défini sur une valeur de jeton de journal qui a été obtenue en appelant SetupGetThreadLogToken ou est l’une des valeurs de jeton de journal définies par le système décrites dans jetons de journal.

  • Category est défini sur TXTLOG_VENDOR, ce qui indique que l’entrée de journal est effectuée par une application fournie par le fournisseur. Les catégories d’événements sont décrites dans Activation des catégories d’événements pour un journal de texte.

  • Indicateurs est défini sur un OR au niveau du bit de TXTLOG_DETAILS et TXTLOG_TIMESTAMP. Dans cet exemple, la profondeur de mise en retrait n’est pas modifiée et la profondeur de retrait actuelle a été précédemment définie sur cinq espaces de texte monospace. Pour plus d’informations sur la modification de la profondeur de retrait, consultez Écriture d’entrées de journal mises en retrait. Les niveaux d’événement sont décrits dans la rubrique Définition du niveau d’événement pour un journal de texte .

  • MessageStr est défini sur TEXT(« Variable d’intérêt : = %d »).

  • La liste de paramètres séparés par des virgules fournit la variable SomeVariable, qui correspond au champ « %d » dans MessageStr.

//The LogToken value was previously returned by call to
//SetupGetThreadLogToken or one of the system-defined log token values
DWORD Category = TXTLOG_VENDOR; 
DWORD Flags = TXTLOG_DETAILS | TXTLOG_TIMESTAMP;
DWORD SomeVariable = 1;   // The variable whose value will be logged

SetupWriteTextLog(LogToken, Category, Flags, TEXT("Variable of interest: = %d"), SomeVariable);

Si la catégorie d’événements TXTLOG_VENDOR est activée et que le niveau d’événement TXTLOG_DETAILS est défini pour le journal texte d’installation de l’appareil, ce code crée une entrée dans le journal d’installation de l’appareil au format suivant, où l’horodatage est remplacé par un horodatage réel.

     2005/02/13 22:06:28.109:    :  Variable of interest: Abc = 1