MsiEnableLogA-Funktion (msi.h)

  • Artikel

Die MsiEnableLog-Funktion legt den Protokollmodus für alle nachfolgenden Installationen fest, die im aufrufenden Prozess initiiert werden.

Syntax

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

Parameter

[in] dwLogMode

Gibt den Protokollmodus an. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
INSTALLLOGMODE_FATALEXIT
 Meldet sich aus dem Arbeitsspeicher oder Informationen zum schwerwiegenden Beenden ab.
INSTALLLOGMODE_ERROR
 Protokolliert die Fehlermeldungen.
INSTALLLOGMODE_EXTRADEBUG
 Sendet zusätzliche Debuginformationen, z. B. Informationen zur Verarbeitung der Erstellung, an die Protokolldatei.

Windows 2000 und Windows XP: Dieses Feature wird nicht unterstützt.
INSTALLLOGMODE_WARNING
 Protokolliert die Warnmeldungen.
INSTALLLOGMODE_USER
 Protokolliert die Benutzeranforderungen.
INSTALLLOGMODE_INFO
 Protokolliert die status Nachrichten, die nicht angezeigt werden.
INSTALLLOGMODE_RESOLVESOURCE
 Anforderung zum Ermitteln eines gültigen Quellspeicherorts.
INSTALLLOGMODE_OUTOFDISKSPACE
 Gibt nicht genügend Speicherplatz auf dem Datenträger an.
INSTALLLOGMODE_ACTIONSTART
 Protokolliert den Start neuer Installationsaktionen.
INSTALLLOGMODE_ACTIONDATA
 Protokolliert den Datensatz mit der Installationsaktion.
INSTALLLOGMODE_COMMONDATA
 Protokolliert die Parameter für die Initialisierung der Benutzeroberfläche.
INSTALLLOGMODE_PROPERTYDUMP
 Protokolliert die Eigenschaftswerte bei der Beendigung.
INSTALLLOGMODE_VERBOSE
 Protokolliert die Informationen in allen anderen Protokollmodi, mit Ausnahme von INSTALLLOGMODE_EXTRADEBUG. Dadurch werden große Mengen von Informationen an eine Protokolldatei gesendet, die für Benutzer im Allgemeinen nicht nützlich ist. Kann für den technischen Support verwendet werden.
INSTALLLOGMODE_LOGONLYONERROR
 Protokollierungsinformationen werden gesammelt, aber seltener in der Protokolldatei gespeichert. Dies kann die Leistung einiger Installationen verbessern, hat aber für große Installationen möglicherweise wenig Vorteile. Die Protokolldatei wird entfernt, wenn die Installation erfolgreich ist. Wenn die Installation fehlschlägt, werden alle Protokollierungsinformationen in der Protokolldatei gespeichert.

Windows Installer 2.0: Dieser Protokollmodus ist nicht verfügbar.

[in] szLogFile

Gibt die Zeichenfolge an, die den vollständigen Pfad zur Protokolldatei enthält. Die Eingabe eines NULL-Werts deaktiviert die Protokollierung. In diesem Fall wird dwlogmode ignoriert. Wenn ein Pfad angegeben wird, darf dwlogmode nicht 0 (null) sein.

[in] dwLogAttributes

Gibt an, wie häufig der Protokollpuffer geleert werden soll.

Wert Bedeutung
INSTALLLOGATTRIBUTES_APPEND
 Wenn dieser Wert festgelegt ist, fügt das Installationsprogramm das vorhandene Protokoll an, das von szLogFile angegeben wird. Wenn nicht festgelegt, wird jedes vorhandene Protokoll, das von szLogFile angegeben wird, überschrieben.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE
 Erzwingt, dass der Protokollpuffer nach jeder Zeile geleert wird. Wenn dieser Wert nicht festgelegt ist, leert das Installationsprogramm den Protokollpuffer nach 20 Zeilen, indem FlushFileBuffers aufgerufen wird.

Rückgabewert

Wert Bedeutung
ERROR_INVALID_PARAMETER
 Es wurde ein ungültiger Protokollmodus angegeben.
ERROR_SUCCESS
 Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Eine Beschreibung der Protokollierungsrichtlinie finden Sie unter Systemrichtlinie.

Der Pfad zum Speicherort der Protokolldatei muss bei Verwendung dieser Funktion bereits vorhanden sein. Der Installer erstellt nicht die Verzeichnisstruktur für die Protokolldatei.

Hinweis

Der msi.h-Header definiert MsiEnableLog als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.
Zielplattform Windows
Kopfzeile msi.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Schnittstellen- und Protokollierungsfunktionen

Logging (Protokollierung)