Функция SetupRemoveSectionFromDiskSpaceListA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. 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
Операция удаления файла из списка. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
|
Операция удаления файла. |
|
Операция копирования файла. |
[in] Reserved1
Должен равняться нулю.
[in] Reserved2
Должен равняться нулю.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Операции с файлами, удаленные функцией SetupRemoveSectionFromDiskSpaceList , обычно являются операциями, которые были добавлены в список с помощью функции SetupAddSectionToDiskSpaceList , хотя это не является обязательным требованием. Функция SetupRemoveSectionFromDiskSpaceList игнорирует файлы в разделе INF, которые не указаны в списке дискового пространства.
Для этой функции требуется INF-файл Windows. Некоторые старые форматы INF-файлов могут не поддерживаться.
Примечание
Заголовок setupapi.h определяет SetupRemoveSectionFromDiskSpaceList в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |