MsiEnableLogA, fonction (msi.h)

  • Article

La fonction MsiEnableLog définit le mode de journalisation pour toutes les installations suivantes qui sont lancées dans le processus d’appel.

Syntaxe

UINT MsiEnableLogA(
  [in] DWORD  dwLogMode,
  [in] LPCSTR szLogFile,
  [in] DWORD  dwLogAttributes
);

Paramètres

[in] dwLogMode

Spécifie le mode journal. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur Signification
INSTALLLOGMODE_FATALEXIT
 Déconnecte la mémoire ou les informations de sortie irrécupérables.
INSTALLLOGMODE_ERROR
 Enregistre les messages d’erreur.
INSTALLLOGMODE_EXTRADEBUG
 Envoie des informations de débogage supplémentaires, telles que des informations de création de handle, au fichier journal.

Windows 2000 et Windows XP : Cette fonctionnalité n’est pas prise en charge.
INSTALLLOGMODE_WARNING
 Enregistre les messages d’avertissement.
INSTALLLOGMODE_USER
 Journalise les demandes de l’utilisateur.
INSTALLLOGMODE_INFO
 Enregistre les messages status qui ne sont pas affichés.
INSTALLLOGMODE_RESOLVESOURCE
 Demande de déterminer un emplacement source valide.
INSTALLLOGMODE_OUTOFDISKSPACE
 Indique un espace disque insuffisant.
INSTALLLOGMODE_ACTIONSTART
 Enregistre le début des nouvelles actions d’installation.
INSTALLLOGMODE_ACTIONDATA
 Enregistre l’enregistrement de données avec l’action d’installation.
INSTALLLOGMODE_COMMONDATA
 Journalise les paramètres pour l’initialisation de l’interface utilisateur.
INSTALLLOGMODE_PROPERTYDUMP
 Enregistre les valeurs de propriété au moment de l’arrêt.
INSTALLLOGMODE_VERBOSE
 Enregistre les informations dans tous les autres modes de journalisation, à l’exception de INSTALLLOGMODE_EXTRADEBUG. Cela envoie de grandes quantités d’informations à un fichier journal qui n’est généralement pas utile aux utilisateurs. Peut être utilisé pour le support technique.
INSTALLLOGMODE_LOGONLYONERROR
 Les informations de journalisation sont collectées, mais sont moins fréquemment enregistrées dans le fichier journal. Cela peut améliorer les performances de certaines installations, mais peut avoir peu d’avantages pour les grandes installations. Le fichier journal est supprimé lorsque l’installation réussit. Si l’installation échoue, toutes les informations de journalisation sont enregistrées dans le fichier journal.

Windows Installer 2.0 : Ce mode de journal n’est pas disponible.

[in] szLogFile

Spécifie la chaîne qui contient le chemin d’accès complet au fichier journal. L’entrée d’une valeur Null désactive la journalisation, auquel cas dwlogmode est ignoré. Si un chemin d’accès est fourni, dwlogmode ne doit pas être égal à zéro.

[in] dwLogAttributes

Spécifie la fréquence à laquelle la mémoire tampon du journal doit être vidée.

Valeur Signification
INSTALLLOGATTRIBUTES_APPEND
 Si cette valeur est définie, le programme d’installation ajoute le journal existant spécifié par szLogFile. S’il n’est pas défini, tout journal existant spécifié par szLogFile est remplacé.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE
 Force le vidage de la mémoire tampon du journal après chaque ligne. Si cette valeur n’est pas définie, le programme d’installation vide la mémoire tampon du journal après 20 lignes en appelant FlushFileBuffers.

Valeur retournée

Valeur Signification
ERROR_INVALID_PARAMETER
 Un mode journal non valide a été spécifié.
ERROR_SUCCESS
 La fonction a réussi.

Remarques

Pour obtenir une description de la stratégie de journalisation, consultez Stratégie système.

Le chemin d’accès à l’emplacement du fichier journal doit déjà exister lors de l’utilisation de cette fonction. Le programme d’installation ne crée pas la structure de répertoires pour le fichier journal.

Notes

L’en-tête msi.h définit MsiEnableLog en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

   
Client minimal pris en charge 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. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible Windows
En-tête msi.h
Bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Fonctions d’interface et de journalisation

Logging