Activation des catégories d’événements pour un journal de texte
SetupAPI écrit une entrée de journal dans un journal texte uniquement si la catégorie d’événements pour l’entrée de journal est activée pour le journal de texte et que le niveau d’événement pour le journal texte est égal ou supérieur au niveau d’événement pour l’entrée de journal.
Le tableau suivant répertorie les catégories d’événements prises en charge par SetupAPI, les constantes de manifeste qui représentent les catégories d’événements et les valeurs des constantes de manifeste.
| Opération de catégorie d’événement | Constante de manifeste de catégorie d’événement | Valeur de catégorie d’événement |
|---|---|---|
Installation des périphériques |
TXTLOG_DEVINST |
0x00000001 |
Gérer les fichiers INF |
TXTLOG_INF |
0x00000002 |
Gérer les files d’attente de fichiers |
TXTLOG_FILEQ |
0x00000004 |
Copie des fichiers |
TXTLOG_COPYFILES |
0x00000008 |
Gérer les paramètres du registre |
TXTLOG_REGISTRY |
0x00000010 |
Vérifier les signatures numériques |
TXTLOG_SIGVERIF |
0x00000020 |
Gérer les propriétés du périphérique et du pilote |
TXTLOG_PROPERTIES |
0x00000040 |
Données de sauvegarde |
TXTLOG_BACKUP |
0x00000080 |
Gérer les boîtes de dialogue de l’interface utilisateur |
TXTLOG_UI |
0x00000100 |
Nouveau gestionnaire d’appareils |
TXTLOG_NEWDEV |
0x01000000 |
Gestionnaire PnP en mode utilisateur |
TXTLOG_UMPNPMGR |
0x02000000 |
Gérer le magasin de pilotes |
TXTLOG_DRIVER_STORE |
0x04000000 |
Programme d’installation de classe ou opération de co-programme d’installation |
TXTLOG_INSTALLER |
0x40000000 |
Opération fournie par le fournisseur |
TXTLOG_VENDOR |
0x80000000 |
Pour activer les catégories d’événements pour les journaux SetupAPI, créez (ou modifiez) la valeur de Registre REG_DWORD suivante :
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogMask
La valeur de Registre LogMask s’applique au journal de texte d’installation de l’appareil et au journal de texte d’installation de l’application.
Si la valeur de Registre LogMask n’existe pas, SetupAPI active toutes les catégories d’événements pour les journaux texte. Si la valeur de Registre LogMask est égale à zéro, SetupAPI désactive toutes les catégories d’événements pour les journaux texte.
La valeur de Registre LogMask est au format 0XVVVVVVVV, où VVVVVVVV est un champ de 32 bits. Pour activer toutes les catégories, définissez LogMask sur 0XFFFFFFFF. Pour activer uniquement des catégories spécifiques, effectuez une opération OR au niveau du bit des constantes de catégorie d’événement correspondantes. Par exemple :
Pour activer uniquement les entrées de journal écrites par les opérations d’installation de l’appareil, définissez LogMask sur la valeur TXTLOG_DEVINST (0X00000001)
Pour activer uniquement les entrées de journal écrites par les opérations d’installation des appareils et les opérations de magasin de pilotes, définissez LogMask sur (TTXTLOG_DRIVER_STORE | TEXTLOG_DEVINST) (0x04000001).
Pour activer uniquement les entrées de journal écrites par des opérations d’installation personnalisées, définissez LogMask sur TXTLOG_VENDOR (0x80000000).