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

Статья
03/15/2023

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

Функция SetupAddToDiskSpaceList добавляет одну операцию удаления или копирования в список дискового пространства. Чтобы добавить все операции с файлами в раздел INF-файла, используйте SetupAddSectionToDiskSpaceList или SetupAddInstallSectionToDiskSpaceList.

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

Синтаксис

WINSETUPAPI BOOL SetupAddToDiskSpaceListA(
  [in] HDSKSPC  DiskSpace,
  [in] PCSTR    TargetFilespec,
  [in] LONGLONG FileSize,
  [in] UINT     Operation,
  [in] PVOID    Reserved1,
  [in] UINT     Reserved2
);

Параметры

[in] DiskSpace

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

[in] TargetFilespec

Имя файла, добавляемого в список дискового пространства. Следует использовать строку, завершающуюся null, которая указывает полный путь. В противном случае путь должен быть относительно текущего каталога.

[in] FileSize

Несжатый размер файла, который будет существовать в целевом каталоге, в байтах. Для получения этих сведений из INF-файла можно использовать SetupGetSourceFileSize . Этот параметр игнорируется для операций FILEOP_DELETE.

[in] Operation

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

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

[in] Reserved1

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

[in] Reserved2

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

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

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

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

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

Требования


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

См. также

Функции

Обзор