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

Статья
11/20/2024

Функция 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".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

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

ведения журнала

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