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

Статья
08/26/2023

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

Функция SetupInitializeFileLog инициализирует файл для записи операций установки и результатов. Это может быть системный журнал, в котором система отслеживает файлы, установленные в составе Windows, или любой другой файл.

Синтаксис

WINSETUPAPI HSPFILELOG SetupInitializeFileLogA(
  [in] PCSTR LogFileName,
  [in] DWORD Flags
);

Параметры

[in] LogFileName

Необязательный указатель на имя файла, используемого в качестве файла журнала. Следует использовать строку со значением NULL. Параметр LogFileName должен быть указан, если флаги не включают SPFILELOG_SYSTEMLOG. Параметр LogFileName не должен указываться, если flags включает SPFILELOG_SYSTEMLOG. Этот параметр может принимать значение NULL.

[in] Flags

Управляет инициализацией файла журнала. Этот параметр может быть сочетанием следующих значений.

SPFILELOG_SYSTEMLOG

Используйте системный журнал файлов. Пользователь должен быть администратором, чтобы указать этот параметр, если не указан параметр SPFILELOG_QUERYONLY и имя_файла LogFileName не указано. Не указывайте SPFILELOG_SYSTEMLOG в сочетании с SPFILELOG_FORCENEW.

SPFILELOG_FORCENEW

Если файл журнала существует, перезапишите его. Если файл журнала существует и этот флаг не указан, все новые установленные файлы добавляются в список в существующем файле журнала. Не указывайте в сочетании с SPFILELOG_SYSTEMLOG.

SPFILELOG_QUERYONLY

Откройте файл журнала только для выполнения запросов.

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

Функция возвращает дескриптор в файл журнала в случае успешного выполнения. В противном случае возвращаемое значение INVALID_HANDLE_VALUE и зарегистрированную ошибку можно получить путем вызова Метода GetLastError.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	setupapi.h
Библиотека	Setupapi.lib
DLL	Setupapi.dll