Share via

SetupLogErrorW-Funktion (setupapi.h)

  • Artikel

[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. 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 zum Installieren von Gerätetreibern verwendet.]

Die SetupLogError-Funktion schreibt eine Fehlermeldung in eine Protokolldatei. Es soll während der Installation von Windows verwendet werden, ist aber immer verfügbar. Es ist nicht für die Verwendung nach der Installation des Betriebssystems vorgesehen. Stattdessen sollte das Ereignisprotokoll verwendet werden.

Syntax

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

Parameter

[in] MessageString

Zeiger auf die Zeichenfolge, die im Setup-Protokoll gespeichert werden soll. Die Nachricht muss mit einer Kombination aus Zeilenrücklauf (\r\n) enden. Sie sollten eine NULL-Zeichenfolge verwenden. Die NULL-Zeichenfolge sollte die Größe des Zielpuffers nicht überschreiten. Die Nachricht wird immer im Aktionsprotokoll gespeichert, setupact.log. Wenn der SchweregradLogSevWarning, LogSevError oder LogSevFatalError lautet, speichert Setup die Nachricht auch im Fehlerprotokoll, setuperr.log. Beide Protokolle werden im Windows-Verzeichnis gespeichert.

[in] Severity

Schweregrad der Nachricht: LogSevInformation, LogSevWarning, LogSevError oder LogSevFatalError.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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

Hinweis

Der setupapi.h-Header 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile setupapi.h
Bibliothek Setupapi.lib
DLL Setupapi.dll
APIs ext-ms-win-setupapi-logging-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Funktionen

Übersicht