SetupWriteTextLogInfLine-Funktion (setupapi.h)
Die SetupWriteTextLogInfLine-Funktion schreibt einen Protokolleintrag in ein SetupAPI-Textprotokoll , das den Text einer angegebenen INF-Dateizeile enthält.
Syntax
WINSETUPAPI VOID SetupWriteTextLogInfLine(
[in] SP_LOG_TOKEN LogToken,
[in] DWORD Flags,
[in] HINF InfHandle,
[in] PINFCONTEXT Context
);
Parameter
[in] LogToken
Ein Protokolltoken , das entweder ein systemdefiniertes Protokolltoken ist oder von SetupGetThreadLogToken zurückgegeben wurde.
[in] Flags
Ein Wert vom Typ DWORD, der ein bitweiser OR von Flagwerten ist, die Folgendes angeben:
- Die Ereignisebene für den Protokolleintrag. Die Ereignisebenen, die für einen Protokolleintrag angegeben werden können, sind identisch mit denen, die für ein Textprotokoll aktiviert werden können. Eine Liste der Flags auf Ereignisebene finden Sie unter Festlegen der Ereignisebene für ein SetupAPI-Textprotokoll.
- Gibt an, ob ein Zeitstempel in den Protokolleintrag eingeschlossen werden soll. Der Zeitstempelflagwert ist TXTLOG_TIMESTAMP.
- Die Änderung, falls vorhanden, an der Einzugstiefe des Abschnitts und des aktuellen Protokolleintrags. Informationen zur Verwendung der Einzugsflags finden Sie unter Schreiben von Einzugsprotokolleinträgen.
[in] InfHandle
Ein Handle für die INF-Datei, das die Textzeile enthält, die in das Textprotokoll geschrieben werden soll. Ein Handle für eine INF-Datei wird abgerufen, indem SetupOpenInfFile aufgerufen wird, was im Platform SDK dokumentiert ist.
[in] Context
Ein Zeiger auf einen INF-Dateikontext, der die Textzeile angibt, die in das Textprotokoll geschrieben werden soll. Ein INF-Dateikontext für eine Zeile wird durch Aufrufen der Funktionen SetupFindXxxLine abgerufen. Informationen zu INF-Dateien und einem INF-Dateikontext finden Sie in den Informationen, die im Platform SDK zur Verwendung von INF-Dateien, zum Abrufen eines INF-Dateikontexts und zur INFCONTEXT-Struktur bereitgestellt werden.
Rückgabewert
Keine
Bemerkungen
SetupWriteTextLogInfLine schreibt einen Protokolleintrag im folgenden Format:
entry-prefixtime-stampinf:indentationinf-line-text(inf-file-namelineline-number)
Hierbei gilt:
- Die Felder Eintragpräfix und Zeitstempel sind identisch mit denen, die unter Format of a Text Log Section Body (Format of a Text Log Section Body) beschrieben werden.
- Das Feld inf-line-text enthält den Text der angegebenen INF-Dateizeile.
- Das Feld inf-file-name enthält den Namen der INF-Datei, die die angegebene INF-Dateizeile enthält.
- Das Feld Zeilennummer enthält die Zeilennummer der angegebenen Zeile in der INF-Datei.
Allgemeine Informationen zum Schreiben von Protokolleinträgen in den SetupAPI-Textprotokollen finden Sie unter SetupAPI-Protokollierung (Windows Vista).
Weitere Informationen zum Betrieb von SetupWriteTextLogInfLine finden Sie unter Aufrufen von SetupWriteTextLogInfLine.
Weitere Informationen zu den verschiedenen Typen von Protokolltoken finden Sie unter Protokolltoken.
Weitere Informationen zur Verwendung von Protokolltoken finden Sie unter Festlegen und Abrufen eines Protokolltokens für einen Thread.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und späteren Windows-Versionen. |
Zielplattform | Desktop |
Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
Bibliothek | Setupapi.lib |
DLL | Setupapi.dll |