SetupWriteTextLogInfLine 函数 (setupapi.h)

  • 项目

SetupWriteTextLogInfLine 函数在包含指定 INF 文件行文本的 SetupAPI 文本日志中写入日志条目。

语法

WINSETUPAPI VOID SetupWriteTextLogInfLine(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Flags,
  [in] HINF         InfHandle,
  [in] PINFCONTEXT  Context
);

参数

[in] LogToken

作为系统定义的 日志令牌 或由 SetupGetThreadLogToken 返回的日志令牌。

[in] Flags

类型为 DWORD 的值，该值是标志值的按位 OR，可指定以下内容：

  • 日志条目的事件级别。 可为日志条目指定的事件级别与可为文本日志启用的事件级别相同。 有关事件级别标志的列表，请参阅 设置 SetupAPI 文本日志的事件级别。
  • 是否在日志条目中包含时间戳。 时间戳标志值TXTLOG_TIMESTAMP。
  • 更改部分和当前日志条目的缩进深度（如果有）。 有关如何使用缩进标志的信息，请参阅 编写缩进日志条目。

[in] InfHandle

INF 文件的句柄，其中包含要写入文本日志的文本行。 通过调用 Platform SDK 中记录的 SetupOpenInfFile 获取 INF 文件的句柄。

[in] Context

指向 INF 文件上下文的指针，该上下文指定要写入文本日志的文本行。 通过调用 SetupFindXxxLine 函数获取行的 INF 文件上下文。 有关 INF 文件和 INF 文件上下文的信息，请参阅平台 SDK 中提供的有关使用 INF 文件、获取 INF 文件上下文和 INFCONTEXT 结构的信息。

返回值

无

备注

SetupWriteTextLogInfLine 以以下格式写入日志条目：

entry-prefixtime-stampinf：indentationinf-line-text (inf-file-nameline-number)

其中：

  • 条目前缀和时间戳字段与文本日志节正文的格式中所述的字段相同。
  • inf-line-text 字段包含指定 INF 文件行的文本。
  • inf-file-name 字段包含包含指定 INF 文件行的 INF 文件的名称。
  • 行号字段包含 INF 文件中指定行的行号。
调用方提供的日志标记和标志以与 SetupWriteTextLog 和 SetupWriteTextLogError 所述的相同方式影响 SetupWriteTextLogInfLine 的操作。 此外， SetupWriteTextLogInfLine 使用 事件类别 TXTLOG_INF。

有关在安装程序API 文本日志中写入日志条目的一般信息，请参阅 Windows Vista) (SetupAPI 日志记录 。

有关 SetupWriteTextLogInfLine 操作的详细信息，请参阅 调用 SetupWriteTextLogInfLine。

有关各种类型的日志令牌的详细信息，请参阅 日志令牌。

有关使用日志令牌的详细信息，请参阅 设置和获取线程的日志令牌。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll

另请参阅

SetupGetThreadLogToken

SetupWriteTextLog

SetupWriteTextLogError