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

Статья
11/20/2024

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

Функция установки SetupRemoveSectionFromDiskSpaceList удаляет операции удаления или копирования файлов, перечисленные в разделе копирование файлов файла INF из списка дискового пространства.

Синтаксис

WINSETUPAPI BOOL SetupRemoveSectionFromDiskSpaceListA(
  [in] HDSKSPC DiskSpace,
  [in] HINF    InfHandle,
  [in] HINF    ListInfHandle,
  [in] PCSTR   SectionName,
  [in] UINT    Operation,
  [in] PVOID   Reserved1,
  [in] UINT    Reserved2
);

Параметры

[in] DiskSpace

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

[in] InfHandle

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

[in] ListInfHandle

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

[in] SectionName

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

[in] Operation

Операция файла для удаления из списка. Этот параметр может быть одним из следующих значений.

Ценность	Значение
FILEOP_DELETE	Операция удаления файла.
FILEOP_COPY	Операция копирования файлов.

[in] Reserved1

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

[in] Reserved2

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

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

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

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

Замечания

Операции с файлами, удаленные функцией SetupRemoveSectionFromDiskSpaceList, обычно являются теми, которые были добавлены в список с помощью функции SetupAddSectionToDiskSpaceList, хотя это не является требованием. Функция SetupRemoveSectionFromDiskSpaceList игнорирует файлы в разделе INF, который не указан в списке дискового пространства.

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

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupAddSectionToDiskSpaceList

SetupRemoveFromDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList

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