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

Статья
03/01/2024

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

Функция SetupRemoveInstallSectionFromDiskSpaceList выполняет поиск строк CopyFiles и DelFiles в разделе Install INF-файла и удаляет операции с файлами, указанные в этих разделах, из списка дискового пространства.

Синтаксис

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

Параметры

[in] DiskSpace

Дескриптор списка дискового пространства.

[in] InfHandle

Выполните обработку открытого INF-файла, содержащего раздел Установка . Если параметр LayoutInfHandle не указан, INF-файл также должен содержать раздел, указанный параметром SectionName.

[in] LayoutInfHandle

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

[in] SectionName

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

[in] Reserved1

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

[in] Reserved2

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

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

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

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

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

Требования

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

См. также

Функции

Обзор

SetupAddInstallSectionToDiskSpaceList

SetupRemoveFromDiskSpaceList

SetupRemoveSectionFromDiskSpaceList