SetupLogErrorA-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 zum Installieren von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Installationsprogrammen für Anwendungen. 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 SetupLogErrorA(
  [in] LPCSTR      MessageString,
  [in] LogSeverity Severity
);

Parameter

[in] MessageString

Zeiger auf die Zeichenfolge, die im Setupprotokoll gespeichert werden soll. Die Nachricht muss mit einer Return-Linefeed-Kombination (\r\n) enden. Sie sollten eine NULL-endende Zeichenfolge verwenden. Die NULL-Zeichenfolge darf 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 Wert ungleich null.

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 von Setup weiter formatiert werden (obwohl er jetzt keine zusätzliche Verarbeitung durchfü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 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
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