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

  • Статья

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

Синтаксис

UINT MsiEnableLogA(
  [in] DWORD  dwLogMode,
  [in] LPCSTR 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

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

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

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