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