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

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

  • Статья

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. 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 [только классические приложения]
Целевая платформа Windows
Header setupapi.h
Библиотека Setupapi.lib
DLL Setupapi.dll
Набор API ext-ms-win-setupapi-logging-l1-1-0 (представлено в Windows 8)

См. также

Функции

Обзор