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

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

Функция setupInstallFromInfSection выполняет все директивы в разделе INF-файла Install.

Если реестр или файл изменен, вызывающий эту функцию, должен иметь права на запись в системный или целевой каталог.

Синтаксис

WINSETUPAPI BOOL SetupInstallFromInfSectionA(
  HWND                Owner,
  HINF                InfHandle,
  PCSTR               SectionName,
  UINT                Flags,
  HKEY                RelativeKeyRoot,
  PCSTR               SourceRootPath,
  UINT                CopyFlags,
  PSP_FILE_CALLBACK_A MsgHandler,
  PVOID               Context,
  HDEVINFO            DeviceInfoSet,
  PSP_DEVINFO_DATA    DeviceInfoData
);

Параметры

Owner

Необязательный указатель на дескриптор окна, которому принадлежат все диалоговые окна, созданные во время установки, например для запроса диска или копирования файлов. Если владелец не указан, эти диалоговые окна становятся окнами верхнего уровня.

InfHandle

Обработайте INF-файл, содержащий обрабатываемый раздел.

SectionName

Имя раздела установки в INF-файле для обработки.

Flags

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

SPINST_INIFILES

Выполнение операций INI-file (UpdateInis, UpdateIniFields строк в разделе установки).

SPINST_REGISTRY

Выполнение операций реестра (AddReg, строк DelReg в разделе "Установка".

SPINST_INI2REG

Выполнение операций реестра INI-file (строки Ini2Reg в разделе Install.

SPINST_LOGCONFIG

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

Выполнение логических операций конфигурации (строк LogConf в разделе Установка. Этот флаг используется только в том случае, если указаны DeviceInfoSet и DeviceInfoData.

Дополнительные сведения об установке драйверов устройств LogConf, DeviceInfoSetили DeviceInfoDataсм. вруководстве программиста DDK.

SPINST_FILES

Выполнение операций с файлами (CopyFiles, DelFiles, строк RenFiles в разделе Install.

SPINST_ALL

Выполните все операции установки.

SPINST_REGISTERCALLBACKAWARE

При использовании директивы INF RegisterDlls INF для самостоятельной регистрации библиотек DLL в Windows 2000 вызывающие элементы SetupInstallFromInfSection могут получать уведомления о каждом файле по мере регистрации или отмены регистрации. Чтобы отправить уведомление SPFILENOTIFY_STARTREGISTRATION или SPFILENOTIFY_ENDREGISTRATION в подпрограмму обратного вызова, включите SPINST_REGISTERCALLBACKAWARE плюс SPINST_REGSVR или SPINST_UNREGSVR. Вызывающий объект также должен задать параметр MsgHandler.

SPINST_REGSVR

Чтобы отправить уведомление в подпрограмму обратного вызова при регистрации файла, включите SPINST_REGISTERCALLBACKAWARE плюс SPINST_REGSVR в Флаги. Вызывающий объект также должен указать параметр MsgHandler.

SPINST_UNREGSVR

Чтобы отправить уведомление в подпрограмму обратного вызова при отмене регистрации файла, включите SPINST_REGISTERCALLBACKAWARE плюс SPINST_UNREGSVR в Флаги. Вызывающий объект также должен указать параметр MsgHandler.

RelativeKeyRoot

Необязательный параметр, который необходимо указать, если флаги включают SPINST_REGISTRY или SPINST_INI2REG. Обработка ключа реестра, который будет использоваться в качестве корневого элемента, когда INF-файл указывает HKR в качестве ключа. Обратите внимание, что этот параметр игнорируется, если setupInstallFromInfSection вызывается с необязательным набором DeviceInfoSet и DeviceInfoData.

SourceRootPath

Корневой каталог исходного кода для копий файлов. Примером будет A:\ или \pegasus\win\install. Если флаги включают SPINST_FILES и SourceRootPath имеет значение NULL, система предоставляет корневой путь по умолчанию.

CopyFlags

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

SP_COPY_DELETESOURCE

Удалите исходный файл после успешной копии. Вызывающий объект не уведомляется, если удаление завершается ошибкой.

SP_COPY_REPLACEONLY

Скопируйте файл только в том случае, если это приведет к перезаписи файла в пути назначения.

SP_COPY_NEWER_OR_SAME

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

Сведения о версии файла, используемые во время проверок версий, указываются в dwFileVersionMS и dwFileVersionLS членов структуры VS_FIXEDFILEINFO, как указано в функциях версии. Если у одного из файлов нет ресурсов версии или если они имеют идентичные сведения о версии, исходный файл считается более новым.

Если исходный файл не равен версии или более поздней версии, а указана CopyMsgHandler, вызывающий объект уведомляется и может отменить копию. Если CopyMsgHandler не указан, файл не копируется.

SP_COPY_NEWER_ONLY

Проверьте каждый файл, копируемый, чтобы узнать, являются ли его ресурсы версии более новой, чем существующую копию в целевом объекте. Если исходный файл является более новым, но не равен в версии существующего целевого объекта, файл копируется.

SP_COPY_NOOVERWRITE

Проверьте, существует ли целевой файл, и, если да, уведомите вызывающего абонента, который может ветоить копию. Если CopyMsgHandler не указан, файл не перезаписывается.

SP_COPY_NODECOMP

Не распаковывайте файл. Если этот флаг задан, целевой файл не получает несжатую форму исходного имени (при необходимости). Например, копирование f:/x86\cmd.ex_ в \install\temp приводит к целевому файлу \install\temp\cmd.ex_. Если флаг SP_COPY_NODECOMP не указан, файл будет распаковлен, а целевой объект будет вызываться \install\temp\cmd.exe. Часть имени файла DestinationName, если указано, удаляется и заменяется именем файла исходного файла. При указании SP_COPY_NODECOMP нет сведений о языке или версии.

SP_COPY_LANGUAGEAWARE

Изучите каждый файл, копируемый, чтобы узнать, отличается ли его язык от языка любого существующего файла, уже размещенного в целевом объекте. Если это так, и указана CopyMsgHandler, вызывающий объект уведомляется и может отменить копию. Если CopyMsgHandler не указан, файл не копируется.

SP_COPY_SOURCE_ABSOLUTE

SourceFile — это полный путь к источнику. Не ищите его в разделе INF-файла SourceDisksNames.

SP_COPY_SOURCEPATH_ABSOLUTE

SourcePathRoot является полной частью исходного файла. Игнорируйте относительный источник, указанный в разделе SourceDisksNames INF-файла для исходного носителя, где находится файл. Этот флаг игнорируется, если указан SP_COPY_SOURCE_ABSOLUTE.

SP_COPY_FORCE_IN_USE

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

SP_COPY_IN_USE_NEEDS_REBOOT

Если файл использовался во время операции копирования, сообщите пользователю о необходимости перезагрузки системы. Этот флаг используется только при последующем вызове SetupPromptReboot или SetupScanFileQueue.

SP_COPY_NOSKIP

Не предоставляйте пользователю возможность пропускать файл.

SP_COPY_FORCE_NOOVERWRITE

Проверьте, существует ли целевой файл и, если да, файл не перезаписан. Вызывающий объект уведомляется.

SP_COPY_FORCE_NEWER

Просмотрите каждый файл, копируемый, чтобы узнать, являются ли его ресурсы версии (или метки времени для файлов, не являющихся изображениями), что это не более новая копия в целевом объекте. Если копируемый файл не является более новым, файл не копируется. Вызывающий объект уведомляется.

SP_COPY_WARNIFSKIP

Если пользователь пытается пропустить файл, предупредите их о том, что пропуск файла может повлиять на установку. (Используется для системных критически важных файлов.)

MsgHandler

Указатель на подпрограмму обратного вызова. Подпрограмма обратного вызова должна быть в формате FileCallback. Дополнительные сведения см. в уведомлениях.

Этот параметр является необязательным, только если параметр флагов не включает SPINST_FILES, SPINST_REGISTERCALLBACKAWARE плюс SPINST_REGSVR или SPINST_UNREGSVR.

MsgHandler необходимо задать, если флаги включают SPINST_FILES. В этом случае уведомление отправляется в подпрограмму обратного вызова при фиксации очереди файлов с SetupCommitFileQueue.

msgHandler необходимо задать, если флаги включают SPINST_REGISTERCALLBACKAWARE плюс SPINST_REGSVR или SPINST_UNREGSVR. В этом случае SPFILENOTIFY_STARTREGISTRATION или SPFILENOTIFY_ENDREGISTRATION отправляется в подпрограмму обратного вызова каждый раз при регистрации или отмене регистрации файла с помощью директивы RegisterDlls INF в Windows 2000.

Context

Значение, передаваемое функции обратного вызова при внутренней фиксации очереди файлов, созданной этой подпрограммой, через SetupCommitFileQueue. Параметр контекста необязателен, только если параметр флагов не включает SPINST_FILES. Этот параметр необходимо указать, если флаги включают SPINST_FILES.

DeviceInfoSet

Необязательный указатель на дескриптор набора сведений об устройстве. Дополнительные сведения о функциях установки установщика устройств см. в руководстве по программе DDK программиста.

DeviceInfoData

Необязательный указатель на указатель на структуру SP_DEVINFO_DATA, которая предоставляет контекст определенному элементу в наборе, указанному DeviceInfoSet. Дополнительные сведения о функциях установки установщика устройств см. в руководстве программиста DDK.

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

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

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

Замечания

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

Для этой функции требуется INF-файл Windows. Некоторые старые форматы INF-файлов могут не поддерживаться.

Примечание

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

SetupInstallFromInfSection будет записывать диагностические сведения втекстовый журнал установки приложения SetupAPI. Этот файл журнала обычно отключен по умолчанию. Его можно включить, изменив уровни ведения журнала общие часть значения setupAPI LogLevel, как описано в разделе Настройка уровней ведения журнала SetupAPI. По соображениям производительности этот файл журнала следует включить только при устранении неполадок. Если файл журнала включен, его можно найти в %windir%\inf\setupapi.app.log.

Требования

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

См. также

Функции

Обзор

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallServicesFromInfSection