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. |