SetupWriteTextLogInfLine-Funktion (setupapi.h)

Artikel
08/26/2023

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.

Das Protokolltoken und die Flags, die ein Aufrufer bereitstellt, wirken sich auf den Vorgang von SetupWriteTextLogInfLine auf die gleiche Weise wie für SetupWriteTextLog und SetupWriteTextLogError aus. Darüber hinaus verwendet SetupWriteTextLogInfLine die Ereigniskategorie TXTLOG_INF.

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

Weitere Informationen

SetupGetThreadLogToken

SetupWriteTextLog

SetupWriteTextLogError

Share via