Définition du niveau d’événement pour un journal de texte

SetupAPI écrit une entrée de journal dans un journal de texte uniquement si le niveau d’événement défini pour un journal de texte est supérieur ou égal au niveau d’événement pour l’entrée de journal et si la catégorie d’événements pour l’entrée de journal est activée pour le journal de texte.

Le tableau suivant répertorie les niveaux d’événements pris en charge par SetupAPI et les constantes de manifeste qui représentent ces niveaux d’événements. TXTLOG_ERROR est le niveau d’événement le plus bas, suivi du niveau d’événement le plus élevé suivant TXTLOG_WARNING, et ainsi de suite. TXTLOG_VERY_VERBOSE est le niveau d’événement le plus élevé.

Niveau d’événement	Constante du manifeste au niveau de l’événement	Valeur du manifeste au niveau de l’événement
Écrire des erreurs uniquement.	TXTLOG_ERROR	1
Écrire les erreurs et les avertissements de problèmes potentiels.	TXTLOG_WARNING	2
Écrire des erreurs, des avertissements et des changements d’état système.	TXTLOG_SYSTEM_STATE_CHANGE	3
Écrire des erreurs, des avertissements, des modifications d’état système et des opérations de haut niveau associées aux modifications d’état.	TXTLOG_SUMMARY	4
Écrire des erreurs, des avertissements, des changements d’état système, des opérations de haut niveau associées aux changements d’état et la plupart des détails opérationnels.	TXTLOG_DETAILS	5
Écrire des erreurs, des avertissements, des changements d’état système, des opérations de haut niveau associées aux changements d’état et tous les détails opérationnels.	TXTLOG_VERBOSE	6
Écrivez toutes les entrées de journal, y compris celles qui peuvent générer une grande quantité d’informations souvent superflues.	TXTLOG_VERY_VERBOSE	7

Pour définir le niveau d’événement pour les journaux de texte SetupAPI, créez (ou modifiez) la valeur de Registre REG_DWORD suivante :
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel

Si la valeur de Registre LogLevel n’existe pas ou a une valeur de zéro, SetupAPI définit le niveau d’événement pour les journaux de texte d’installation de l’application et de l’appareil sur les valeurs par défaut décrites dans le tableau suivant :

Journal de texte	Valeur par défaut (Windows 7 et versions ultérieures)	Valeur par défaut (Windows Vista SP2)	Valeur par défaut (Windows Vista SP1 et versions antérieures)
Journal du texte d’installation de l’application (SetupAPI.app.log)	TXTLOG_SUMMARY	TXTLOG_WARNING	TXTLOG_DETAILS
Journal du texte d’installation de l’appareil (SetupAPI.dev.log)	TXTLOG_DETAILS	TXTLOG_DETAILS	TXTLOG_DETAILS

Pour plus d’informations sur ces fichiers journaux texte, consultez Configuration Logs de texte API.

La valeur de Registre LogLevel est au format 0xUUUUGHVW, où :

• Les huit bits d’ordre inférieur, représentés par le masque 0x000000VW, spécifient si la journalisation est activée pour le journal d’installation de l’application et spécifient le niveau d’événement pour le journal de l’application.

• Les huit bits les plus élevés suivants, représentés par le masque 0x0000GH00, spécifient si la journalisation est activée pour le journal de texte d’installation de l’appareil et spécifient le niveau d’événement pour le journal du texte d’installation de l’appareil.

• Les bits de niveau le plus élevé, représentés par le masque 0xUUUU0000, ne sont pas utilisés.

La valeur de 0 bitsVW contrôle la journalisation pour le journal d’installation de l’application, comme indiqué dans le tableau suivant.

Valeur 0xVW	Description
Zéro (valeur par défaut)	La journalisation est activée et le niveau d’événement est défini sur la valeur par défaut, comme décrit précédemment.
0x01 à 0x0F	Désactive la journalisation.
0x10 à 0x7F	Active la journalisation et définit le niveau d’événement sur 0xV.

La valeur de 0 bitsGH contrôle la journalisation du journal du texte d’installation de l’appareil, comme indiqué dans le tableau suivant.

Valeur 0xGH	Description
Zéro (valeur par défaut)	La journalisation est activée et le niveau d’événement est défini sur la valeur par défaut, comme décrit précédemment.
0x01 à 0x0F	Désactive la journalisation.
0x10 à 0x7F	Active la journalisation et définit le niveau d’événement sur 0xG.

Le tableau suivant fournit des exemples de valeurs LogLevel standard.

Valeur LogLevel	Niveaux d’événement définis pour les journaux de texte
0x00000000	Par défaut, active la journalisation pour le journal d’installation de l’application et le journal d’installation de l’appareil. Définit le niveau de journalisation sur les valeurs par défaut pour les deux journaux.
0x00000101	Désactive la journalisation pour le journal d’installation de l’application et le journal d’installation de l’appareil.
0x00001010	Active la journalisation pour le journal d’installation de l’application et le journal d’installation de l’appareil. Définit le niveau de journalisation sur TXTLOG_ERROR pour les deux journaux.
0x00002020	Active la journalisation pour le journal d’installation de l’application et le journal d’installation de l’appareil. Définit le niveau de journalisation sur TXTLOG_WARNING pour les deux journaux.
0x00005050	Active la journalisation pour le journal d’installation de l’application et le journal d’installation de l’appareil. Définit le niveau de journalisation sur TXTLOG_DETAILS pour les deux journaux.
0x00006060	Active la journalisation pour le journal d’installation de l’application et le journal d’installation de l’appareil. Définit le niveau de journalisation sur TXTLOG_VERBOSE pour les deux journaux.
0x00007070	Active la journalisation pour le journal d’installation de l’application et le journal d’installation de l’appareil. Définit le niveau de journalisation sur TXTLOG_VERY_VERBOSE pour les deux journaux.