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

Статья
11/20/2024

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

Функция установки SetupRemoveFromDiskSpaceList удаляет операцию удаления или копирования файла из списка дискового пространства.

Синтаксис

WINSETUPAPI BOOL SetupRemoveFromDiskSpaceListW(
  [in] HDSKSPC DiskSpace,
  [in] PCWSTR  TargetFilespec,
  [in] UINT    Operation,
  [in] PVOID   Reserved1,
  [in] UINT    Reserved2
);

Параметры

[in] DiskSpace

Обработка списка дискового пространства.

[in] TargetFilespec

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

[in] Operation

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

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

[in] Reserved1

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

[in] Reserved2

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

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

Если файл не был в списке , функция установки SetupRemoveFromDiskSpace List возвращает ненулевое значение и GetLastError возвращает ERROR_INVALID_DRIVE или ERROR_INVALID_NAME. Если файл был в списке, после успешного выполнения подпрограмма возвращает ненулевое значение и GetLastError возвращает NO_ERROR.

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

Замечания

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList

SetupRemoveSectionFromDiskSpaceList

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