SetupInitializeFileLogA-Funktion (setupapi.h)

Artikel
08/26/2023

[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 SetupInitializeFileLog-Funktion initialisiert eine Datei, um Installationsvorgänge und -ergebnisse aufzuzeichnen. Dies kann das Systemprotokoll sein, in dem das System die als Teil von Windows installierten Dateien nachverfolgt, oder eine beliebige andere Datei.

Syntax

WINSETUPAPI HSPFILELOG SetupInitializeFileLogA(
  [in] PCSTR LogFileName,
  [in] DWORD Flags
);

Parameter

[in] LogFileName

Optionaler Zeiger auf den Dateinamen der Datei, die als Protokolldatei verwendet werden soll. Sie sollten eine NULL-endende Zeichenfolge verwenden. Der LogFileName-Parameter muss angegeben werden, wenn Flags keine SPFILELOG_SYSTEMLOG enthalten. Der LogFileName-Parameter darf nicht angegeben werden, wenn Flags SPFILELOG_SYSTEMLOG enthält. Dieser Parameter kann NULL sein.

[in] Flags

Steuert die Protokolldateiinitialisierung. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

SPFILELOG_SYSTEMLOG

Verwenden Sie das Systemdateiprotokoll. Der Benutzer muss ein Administrator sein, um diese Option anzugeben, es sei denn, SPFILELOG_QUERYONLY und LogFileName ist nicht angegeben. Geben Sie SPFILELOG_SYSTEMLOG nicht in Kombination mit SPFILELOG_FORCENEW an.

SPFILELOG_FORCENEW

Wenn die Protokolldatei vorhanden ist, überschreiben Sie sie. Wenn die Protokolldatei vorhanden ist und dieses Flag nicht angegeben ist, werden alle neuen installierten Dateien der Liste in der vorhandenen Protokolldatei hinzugefügt. Geben Sie nicht in Kombination mit SPFILELOG_SYSTEMLOG an.

SPFILELOG_QUERYONLY

Öffnen Sie die Protokolldatei nur für Abfragen.

Rückgabewert

Die Funktion gibt das Handle an die Protokolldatei zurück, wenn es erfolgreich ist. Andernfalls wird der Rückgabewert INVALID_HANDLE_VALUE, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.

Hinweise

Hinweis

Der Setupapi.h-Header definiert SetupInitializeFileLog 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