Поделиться через

Запись в журнале сведений

В следующем примере показано, как приложение обычно может вызывать SetupWriteTextLog для записи в текстовый журнал SetupAPI записи, которая не является предупреждением или сообщением об ошибке.

Сведения о вызове SetupWriteTextLog для регистрации сообщения об ошибке см. в разделе Вызов SetupWriteTextLog для записи в журнал ошибки или предупреждения.

Приложение вызывает SetupWriteTextLog, предоставляя следующие значения параметров:

  • LogToken имеет значение маркера журнала, которое было получено путем вызова SetupGetThreadLogToken или является одним из системных значений маркера журнала, описанных в разделе Маркеры журнала.

  • Для параметра Category задано значение TXTLOG_VENDOR, указывающее, что запись журнала сделана приложением, предоставленным поставщиком. Категории событий описаны в разделе Включение категорий событий для текстового журнала.

  • Для флагов задается побитовое ИЛИ TXTLOG_DETAILS и TXTLOG_TIMESTAMP. В этом примере глубина отступа не изменяется, а текущая глубина отступа ранее была установлена в пять текстовых пробелов в монопространстве. Сведения об изменении глубины отступов см. в разделе Запись записей журнала с отступом. Уровни событий описаны в разделе Настройка уровня событий для текстового журнала .

  • Параметр MessageStr имеет значение TEXT("Интересующая переменная: = %d").

  • Список параметров, разделенных запятыми, предоставляет переменную SomeVariable, которая соответствует полю "%d" в MessageStr.

//The LogToken value was previously returned by call to
//SetupGetThreadLogToken or one of the system-defined log token values
DWORD Category = TXTLOG_VENDOR; 
DWORD Flags = TXTLOG_DETAILS | TXTLOG_TIMESTAMP;
DWORD SomeVariable = 1;   // The variable whose value will be logged

SetupWriteTextLog(LogToken, Category, Flags, TEXT("Variable of interest: = %d"), SomeVariable);

Если включена категория событий TXTLOG_VENDOR и для текстового журнала установки устройства задан уровень событий TXTLOG_DETAILS, этот код создаст запись в журнале установки устройств в следующем формате, где метка времени будет заменена фактической меткой времени.

     2005/02/13 22:06:28.109:    :  Variable of interest: Abc = 1
  • Last updated on