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

Статья
11/20/2024

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

Функция setupCreateDiskSpaceList создает список дискового пространства.

Синтаксис

WINSETUPAPI HDSKSPC SetupCreateDiskSpaceListA(
  [in] PVOID Reserved1,
  [in] DWORD Reserved2,
  [in] UINT  Flags
);

Параметры

[in] Reserved1

Неиспользуемое значение должно быть равно нулю.

[in] Reserved2

Неиспользуемое значение должно быть равно нулю.

[in] Flags

Этот параметр может быть следующим значением.

SPDSL_IGNORE_DISK

Операции с файлами, добавленные в список, будут игнорировать файлы, которые уже существуют на диске. Например, если диск содержит 5000-байтовый файл, C:\MyDir\MyFile, и вы добавляете операцию копирования в список дискового пространства для новой версии C:\MyDir\MyFile, то есть 6500 байт, необходимое пространство будет 6500 байт (вместо 1500 байт, которое возвращается, если не задано SPDSL_IGNORE_DISK).

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

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

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

Замечания

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupDespaceSpaceList

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