SetupInitializeFileLogA-Funktion (setupapi.h)
[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 SetupInitializeFileLog Funktion initialisiert eine Datei, um Installationsvorgänge und Ergebnisse aufzuzeichnen. Dies kann das Systemprotokoll sein, in dem das System die im Rahmen von Windows oder einer anderen Datei installierten Dateien nachverfolgt.
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--terminated-Zeichenfolge verwenden. Der LogFileName Parameter muss angegeben werden, wenn Flags keine SPFILELOG_SYSTEMLOG enthält. Der LogFileName Parameter darf nicht angegeben werden, wenn Flags SPFILELOG_SYSTEMLOG enthält. Dieser Parameter kann NULL-sein.
[in] Flags
Steuert die Initialisierung der Protokolldatei. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.
SPFILELOG_SYSTEMLOG
Verwenden Sie das Systemdateiprotokoll. Der Benutzer muss ein Administrator sein, um diese Option anzugeben, es sei denn, SPFILELOG_QUERYONLY angegeben ist und LogFileName- nicht angegeben ist. 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 installierten neuen 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 zum Abfragen.
Rückgabewert
Die Funktion gibt das Handle an die Protokolldatei zurück, wenn sie erfolgreich ist. Andernfalls ist der Rückgabewert INVALID_HANDLE_VALUE und der protokollierte Fehler kann durch einen Aufruf von GetLastErrorabgerufen werden.
Bemerkungen
Anmerkung
Der Header setupapi.h definiert SetupInitializeFileLog als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |