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

Статья
11/20/2024

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

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

Сжатие целевого диска игнорируется этой функцией. Предполагается, что файлы занимают полный размер на целевом диске.

Синтаксис

WINSETUPAPI BOOL SetupAddSectionToDiskSpaceListW(
  [in] HDSKSPC DiskSpace,
  [in] HINF    InfHandle,
  [in] HINF    ListInfHandle,
  [in] PCWSTR  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

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

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

[in] Reserved1

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

[in] Reserved2

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

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

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

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

Замечания

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

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupAddInstallSectionToDiskSpaceList

SetupAddToDiskSpaceList

SetupRemoveSectionFromDiskSpaceList

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