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

Функция MsiEnableLogW (msi.h)

  • Статья

Функция MsiEnableLog задает режим ведения журнала для всех последующих установок, инициированных в вызывающем процессе.

Синтаксис

UINT MsiEnableLogW(
  [in] DWORD   dwLogMode,
  [in] LPCWSTR szLogFile,
  [in] DWORD   dwLogAttributes
);

Параметры

[in] dwLogMode

Указывает режим журнала. Этот параметр может иметь одно или несколько из следующих значений.

Значение Значение
INSTALLLOGMODE_FATALEXIT
 Выходит из памяти или неустранимые сведения о выходе.
INSTALLLOGMODE_ERROR
 Регистрирует сообщения об ошибках.
INSTALLLOGMODE_EXTRADEBUG
 Отправляет дополнительные отладочные сведения, такие как сведения о создании дескрипторов, в файл журнала.

Windows 2000 и Windows XP: Эта функция не поддерживается.
INSTALLLOGMODE_WARNING
 Регистрирует предупреждающие сообщения.
INSTALLLOGMODE_USER
 Регистрирует запросы пользователей.
INSTALLLOGMODE_INFO
 Регистрирует сообщения о состоянии, которые не отображаются.
INSTALLLOGMODE_RESOLVESOURCE
 Запрос на определение допустимого расположения источника.
INSTALLLOGMODE_OUTOFDISKSPACE
 Указывает на нехватку места на диске.
INSTALLLOGMODE_ACTIONSTART
 Записывает в журнал начало новых действий по установке.
INSTALLLOGMODE_ACTIONDATA
 Записывает запись данных в журнал с помощью действия установки.
INSTALLLOGMODE_COMMONDATA
 Регистрирует параметры для инициализации пользовательского интерфейса.
INSTALLLOGMODE_PROPERTYDUMP
 Регистрирует значения свойств при завершении работы.
INSTALLLOGMODE_VERBOSE
 Регистрирует сведения во всех остальных режимах журнала, за исключением INSTALLLOGMODE_EXTRADEBUG. При этом большие объемы данных отправляются в файл журнала, который обычно не является полезным для пользователей. Может использоваться для технической поддержки.
INSTALLLOGMODE_LOGONLYONERROR
 Данные журнала собираются, но реже сохраняются в файле журнала. Это может повысить производительность некоторых установок, но может иметь мало преимуществ для больших установок. После успешной установки файл журнала удаляется. Если установка завершается сбоем, все данные журнала сохраняются в файле журнала.

Установщик Windows 2.0: Этот режим журнала недоступен.

[in] szLogFile

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

[in] dwLogAttributes

Указывает частоту очистки буфера журнала.

Значение Значение
INSTALLLOGATTRIBUTES_APPEND
 Если это значение задано, установщик добавляет существующий журнал, указанный szLogFile. Если значение не задано, любой существующий журнал, указанный szLogFile , перезаписывается.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE
 Принудительно очищает буфер журнала после каждой строки. Если это значение не задано, установщик очищает буфер журнала после 20 строк, вызывая FlushFileBuffers.

Возвращаемое значение

Значение Значение
ERROR_INVALID_PARAMETER
 Указан недопустимый режим журнала.
ERROR_SUCCESS
 Функция выполнена успешно.

Комментарии

Описание политики ведения журнала см. в разделе Системная политика.

При использовании этой функции путь к расположению файла журнала уже должен существовать. Установщик не создает структуру каталогов для файла журнала.

Примечание

Заголовок msi.h определяет MsiEnableLog в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP. Сведения о минимальном пакете обновления Windows, необходимом для версии установщика Windows, см. в разделе Требования к установщику Windows Run-Time.
Целевая платформа Windows
Header msi.h
Библиотека Msi.lib
DLL Msi.dll

См. также раздел

Интерфейс и функции ведения журнала

Ведение журнала