Edit

Share via

Log Tokens

  • Article

SetupAPI text logging uses log tokens to write entries in a SetupAPI text log.

A class installer or co-installer must use the log token that is returned by SetupGetThreadLogToken to write log entries in a text log section that was established by the SetupAPI installation operation that called the installer. SetupAPI text logging also provides system-defined log tokens, which an installation application can use to write log entries that are not part of a text log section.

The following system-defined log tokens are provided by SetupAPI text logging:

LOGTOKEN_UNSPECIFIED
Represents the part of an unspecified text log that is not part of a text log section. By default, the SetupAPI logging functions write a log entry in the application installation text log if this token value is specified.

LOGTOKEN_NO_LOG
Represents the null log. The SetupAPI logging functions do not write a log entry if this token value is specified.

LOGTOKEN_SETUPAPI_APPLOG
Represents the part of the application text log (SetupAPI.app.log) that is not part of a text log section. The SetupAPI logging functions write log entries in the application installation text log if this token value is specified.

LOGTOKEN_SETUPAPI_DEVLOG
Represents the part of the device installation text log (SetupAPI.dev.log) that is not part of a text log section. The SetupAPI logging functions write log entries in the device installation text log if this token value is specified.