Функция SetupLogErrorA (setupapi.h)

Статья
11/20/2024

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]

Функция setupLogError записывает сообщение об ошибке в файл журнала. Он предназначен для использования во время установки Windows, но он всегда доступен. Он не предназначен для использования после установки операционной системы— вместо него следует использовать журнал событий.

Синтаксис

WINSETUPAPI BOOL SetupLogErrorA(
  [in] LPCSTR      MessageString,
  [in] LogSeverity Severity
);

Параметры

[in] MessageString

Указатель на строку, которая должна быть сохранена в журнале установки. Сообщение должно заканчиваться сочетанием возвращаемой строки (\r\n). Следует использовать строку, завершаемую значением NULL. Строка, завершающаяся значением NULL, не должна превышать размер целевого буфера. Сообщение всегда сохраняется в журнале действий setupact.log. Если серьезности LogSevWarning, LogSevErrorили LogSevFatalError, программа установки также сохраняет сообщение в журнал ошибок setuperr.log. Оба журнала хранятся в каталоге Windows.

[in] Severity

Серьезность сообщения: LogSevInformation, LogSevWarning, LogSevErrorили LogSevFatalError.

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

Если функция выполнена успешно, возвращаемое значение является ненулевое значение.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Журнал действий предназначен для записи всех изменений, внесенных в систему во время установки Windows.
Журнал ошибок предназначен только для ошибок при установке Только Windows.
Параметр MessageString может быть отформатирован программой установки (хотя он не выполняет дополнительную обработку сейчас).
Журнал ошибок будет представлен пользователю в конце установки системы.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll
набор API	ext-ms-win-setupapi-logging-l1-1-0 (представлено в Windows 8)

См. также

Функции

Обзор

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