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

Статья
03/15/2023

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

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

Синтаксис

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

Параметры

[in] DiskSpace

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

[in] InfHandle

Выполните обработку открытого INF-файла, содержащего раздел Установка для поиска. Если параметр 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