MsiEnableLogA-Funktion (msi.h)

Artikel
11/20/2024

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

Wert	Bedeutung
INSTALLLOGMODE_FATALEXIT	Meldet sich nicht mehr im Arbeitsspeicher oder bei schwerwiegenden Beendigungsinformationen an.
INSTALLLOGMODE_ERROR	Protokolliert die Fehlermeldungen.
INSTALLLOGMODE_EXTRADEBUG	Sendet zusätzliche Debuginformationen, z. B. Behandeln von Erstellungsinformationen, 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 Statusmeldungen, die nicht angezeigt werden.
INSTALLLOGMODE_RESOLVESOURCE	Anforderung zum Ermitteln eines gültigen Quellspeicherorts.
INSTALLLOGMODE_OUTOFDISKSPACE	Gibt nicht genügend Speicherplatz an.
INSTALLLOGMODE_ACTIONSTART	Protokolliert den Start von Neuen 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 beim Beenden.
INSTALLLOGMODE_VERBOSE	Protokolliert die Informationen in allen anderen Protokollmodi, mit Ausnahme von INSTALLLOGMODE_EXTRADEBUG. Dadurch werden große Mengen an Informationen an eine Protokolldatei gesendet, die für Benutzer nicht allgemein nützlich ist. Kann für technischen Support verwendet werden.
INSTALLLOGMODE_LOGONLYONERROR	Protokollierungsinformationen werden gesammelt, werden jedoch weniger häufig in der Protokolldatei gespeichert. Dies kann die Leistung einiger Installationen verbessern, kann aber für große Installationen wenig Nutzen haben. 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. Durch die Eingabe eines Null-Werts wird die Protokollierung deaktiviert. In diesem Fall wird dwlogmode ignoriert. Wenn ein Pfad angegeben wird, darf dwlogmode nicht 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 durch szLogFileangegebene vorhandene Protokoll an. Falls nicht festgelegt, wird ein durch szLogFile- angegebenes Protokoll überschrieben.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE	Erzwingt, dass der Protokollpuffer nach jeder Zeile geleert wird. Wenn dieser Wert nicht festgelegt ist, löscht das Installationsprogramm den Protokollpuffer nach 20 Zeilen, indem FlushFileBuffersaufgerufen wird.

Rückgabewert

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

Bemerkungen

Eine Beschreibung der Protokollierungsrichtlinie finden Sie unter Systemrichtlinie.

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

Anmerkung

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

Anforderung	Wert
mindestens unterstützte 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 von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen.
Zielplattform-	Fenster
Header-	msi.h
Library	Msi.lib
DLL-	Msi.dll

Siehe auch

Schnittstellen- und Protokollierungsfunktionen

Protokollierung

Freigeben über