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

Статья
08/26/2023

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

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

Требования

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

См. также

Функции

Обзор

SetupAddSectionToDiskSpaceList

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList