Installer.EnableLog, méthode

Article
06/13/2023

La méthode EnableLog de l’objet Installer active la journalisation du type de message sélectionné pour toutes les sessions d’installation suivantes dans l’espace du processus actif.

Syntaxe

Installer.EnableLog(
  logMode,
  logFile
)

Paramètres

logMode

Chaîne obligatoire qui contient des lettres représentant les types de messages à enregistrer dans le journal. La chaîne peut être une combinaison des valeurs suivantes.

Valeur	Description
I	Messages d’information uniquement.
w	Messages d’avertissement pour des erreurs récupérables.
e	Messages d’erreur pour des erreurs potentiellement irrécupérables.
f	Liste des fichiers en cours d’utilisation devant être remplacés.
a	Notification de début d’action.
r	Enregistrement de données d’action contenant du contenu propre à l’action.
u	Messages pour des requêtes utilisateur.
c	Paramètres d’initialisation de l’interface utilisateur.
m	Message de mémoire insuffisante.
v	Envoie de grandes quantités d’informations dans le fichier journal qui ne sont généralement pas utiles aux utilisateurs. Peut être utilisé pour le support.
p	Vide la table de propriétés ; "property = value" à l’arrêt du moteur
+	Ajoute les informations au fichier journal existant.
!	Envoie chaque ligne vers le fichier journal.
x	Informations de débogage supplémentaires. Cette option est disponible uniquement avec Windows Server 2003.
o	Messages d’espace disque insuffisant.

logFile

Chaîne obligatoire contenant le chemin du fichier journal à créer. Utilisez une chaîne vide ("") pour désactiver la journalisation.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Le chemin de l’emplacement du fichier journal doit déjà exister au moment de l’utilisation de cette méthode. Installer ne crée pas la structure de répertoires pour le fichier journal.

Les options de journalisation définies avec EnableLog remplacent tous les paramètres de stratégie de journalisation existants dans Windows Installer.

La journalisation remplace un fichier journal existant par défaut. Vous devez utiliser la lettre '+' en mode journalisation pour l’ajout à un fichier journal existant.

L’option '!' est déconseillée, car elle peut ralentir considérablement l’installation. Cette option peut toutefois être utile pour déboguer une installation.

L’exemple de script suivant active la journalisation détaillée pour une installation. À la fin de l’installation, le fichier journal généré se trouvera dans c:\temp\install.log.

    Dim Installer
    Set Installer = CreateObject("WindowsInstaller.Installer")
    Installer.EnableLog "voicewarmup", "c:\temp\install.log"
    Installer.InstallProduct "\\server\share\products\sample\sample.msi"

Configuration requise

Condition requise	Valeur
Version	Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
DLL	Msi.dll
IID	IID_IInstaller est défini comme 000C1090-0000-0000-C000-000000000046

Voir aussi

Journalisation de Windows Installer

Partager via