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

Статья
11/20/2024

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

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

Синтаксис

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

Параметры

[in] LogFileName

Необязательный указатель на имя файла, используемого в качестве файла журнала. Следует использовать строку null-terminated. Параметр LogFileName необходимо указать, если флаги не включают SPFILELOG_SYSTEMLOG. Параметр LogFileName не должен быть указан, если Флаги включают 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll

См. также

Функции

Обзор

SetupLogFile

SetupTerminateFileLog

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