Функция SetupInitializeFileLogA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. 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 |