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