SetupLogErrorW-Funktion (setupapi.h)

Artikel
11/20/2024

[Diese Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin für die Installation von Gerätetreibern verwendet.]

Die SetupLogError--Funktion schreibt eine Fehlermeldung in eine Protokolldatei. Sie soll während der Installation von Windows verwendet werden, ist aber immer verfügbar. Es ist nicht vorgesehen, nach der Installation des Betriebssystems zu verwenden – stattdessen sollte das Ereignisprotokoll verwendet werden.

Syntax

WINSETUPAPI BOOL SetupLogErrorW(
  [in] LPCWSTR     MessageString,
  [in] LogSeverity Severity
);

Parameter

[in] MessageString

Zeigen Sie auf die Zeichenfolge, die im Setup-Protokoll gespeichert werden soll. Die Nachricht muss mit einer Kombination aus Rückgabezeilenfeed (\r\n) enden. Sie sollten eine mit Null beendete Zeichenfolge verwenden. Die mit Null beendete Zeichenfolge darf die Größe des Zielpuffers nicht überschreiten. Die Nachricht wird immer im Aktionsprotokoll setupact.log gespeichert. Wenn SchweregradLogSevWarning, LogSevErroroder LogSevFatalError-ist, speichert Setup auch die Nachricht im Fehlerprotokoll setuperr.log. Beide Protokolle werden im Windows-Verzeichnis gespeichert.

[in] Severity

Schweregrad der Nachricht, einer der folgenden: LogSevInformation, LogSevWarning, LogSevErroroder LogSevFatalError.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Das Aktionsprotokoll dient zum Aufzeichnen aller Änderungen, die während der Installation von Windows am System vorgenommen wurden.
Das Fehlerprotokoll ist nur für Fehler bei der Installation von Windows vorgesehen.
Der MessageString-Parameter kann durch Setup weiter formatiert werden (obwohl es jetzt keine zusätzliche Verarbeitung ausführt).
Das Fehlerprotokoll wird dem Benutzer am Ende des Systemsetups angezeigt.

Anmerkung

Der Header setupapi.h definiert SetupLogError 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 XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	setupapi.h
Library	Setupapi.lib
DLL-	Setupapi.dll
API-Satz	ext-ms-win-setupapi-logging-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Funktionen

Übersicht

Freigeben über