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

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

[in] LayoutInfHandle

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

[in] SectionName

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

[in] Reserved1

Должен равняться нулю.

[in] Reserved2

Должен равняться нулю.

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

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

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

Комментарии

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

Примечание

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

Требования

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

См. также

Функции

Обзор

SetupAddSectionToDiskSpaceList

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList