Функция MsiEnableLogA (msi.h)
Функция MsiEnableLog задает режим журнала для всех последующих установок, инициированных в процессе вызова.
Синтаксис
UINT MsiEnableLogA(
[in] DWORD dwLogMode,
[in] LPCSTR szLogFile,
[in] DWORD dwLogAttributes
);
Параметры
[in] dwLogMode
Указывает режим журнала. Этот параметр может быть одним или несколькими из следующих значений.
[in] szLogFile
Указывает строку, содержащую полный путь к файлу журнала. Ввод значения NULL отключает ведение журнала. В этом случае dwlogmode игнорируется. Если указан путь, dwlogmode не должен быть равен нулю.
[in] dwLogAttributes
Указывает частоту очистки буфера журнала.
Значение | Значение |
---|---|
|
Если это значение задано, установщик добавляет существующий журнал, указанный в файле szLogFile. Если этот параметр не задан, любой существующий журнал, указанный szLogFile , перезаписывается. |
|
Принудительно очищает буфер журнала после каждой строки. Если это значение не задано, установщик очищает буфер журнала после 20 строк, вызывая FlushFileBuffers. |
Возвращаемое значение
Значение | Значение |
---|---|
|
Указан недопустимый режим журнала. |
|
Функция выполнена успешно. |
Комментарии
Описание политики ведения журнала см. в разделе Системная политика.
При использовании этой функции путь к расположению файла журнала уже должен существовать. Установщик не создает структуру каталогов для файла журнала.
Примечание
Заголовок 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 |