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

Статья
11/20/2024

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

Функция setupAddInstallSectionToDiskSpaceList выполняет поиск CopyFile и строк DelFile в разделе Install файла INF. Затем функция добавляет операции файлов, указанные в этих разделах, в список дискового пространства.

Синтаксис

WINSETUPAPI BOOL SetupAddInstallSectionToDiskSpaceListW(
  [in] HDSKSPC DiskSpace,
  [in] HINF    InfHandle,
  [in] HINF    LayoutInfHandle,
  [in] PCWSTR  SectionName,
  [in] PVOID   Reserved1,
  [in] UINT    Reserved2
);

Параметры

[in] DiskSpace

Обработка списка дискового пространства.

[in] InfHandle

Обработайте открытый INF-файл, содержащий раздел install . Если ListInfHandle не указано, INF-файл также должен содержать раздел, указанный SectionName.

[in] LayoutInfHandle

Этот параметр, если он указан, предоставляет дескриптор INF-файлу, который содержит разделы SourceDisksFiles. В противном случае предполагается, что этот раздел существует в INF-файле, указанном InfHandle.

[in] SectionName

Имя раздела "Установка", которое будет добавлено в список дискового пространства. Следует использовать строку, завершаемую значением NULL.

[in] Reserved1

Должно быть равно нулю.

[in] Reserved2

Должно быть равно нулю.

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

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

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

Замечания

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

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupAddSectionToDiskSpaceList

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList

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