调用 SetupWriteTextLog

SetupWriteTextLog 将包含安装事件相关信息的单个条目添加到 SetupAPI 文本日志。

如 文本日志节正文的格式中所述，日志条目的格式由以下字段组成：

entry_prefix time_stamp event_category indentation formatted_message

若要调用 SetupWriteTextLog，应用程序会提供以下信息：

• 通过调用 SetupGetThreadLogToken 或其中一个系统定义的 日志令牌获取的文本日志中的节的日志令牌。 如果日志令牌与文本日志部分相关联， SetupWriteTextLog 将写入该部分中的日志条目。 否则， SetupWriteTextLog 会将日志条目添加到未包含在文本日志部分中的日志部分。 此外， SetupWriteTextLog 是否写入日志条目，以及 SetupWriteTextLog 向哪个文本日志写入该条目取决于系统定义的日志令牌值。

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

• 为文本日志启用事件类别中所述的事件类别之一。 如果为文本日志启用了条目的事件类别， 则 SetupWriteTextLog 会将条目添加到文本日志;否则， SetupWriteTextLog 不会将条目写入文本日志。

• 一个标志值，该值是系统定义的常量（指定事件级别、缩进深度以及是否包含时间戳）的按位 OR。 设置文本日志的事件级别中介绍了事件级别。 如果为文本日志设置的事件级别大于或等于条目的事件级别， 则 SetupWriteTextLog 会将日志条目写入文本日志;否则， SetupWriteTextLog 不会将日志条目写入文本日志。 通过使用缩进，可以对格式化消息进行排列，使节中的信息更易于阅读和理解。 有关详细信息，请参阅 编写缩进日志条目。

• 一个与 printf 兼容的格式字符串，用于设置消息和格式字符串后面的逗号分隔变量列表的格式。

• 以逗号分隔的变量列表，其值由 printf 兼容的格式字符串设置格式。

有关如何调用 SetupWriteTextLog 以记录有关不是错误或警告的事件的信息的示例，请参阅 编写信息日志条目。

有关如何调用 SetupWriteTextLog 以记录有关错误或警告的信息的示例，请参阅 编写错误或警告日志条目。