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

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

  • Статья

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

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

Синтаксис

WINSETUPAPI BOOL SetupRemoveFromDiskSpaceListA(
  [in] HDSKSPC DiskSpace,
  [in] PCSTR   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

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

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

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

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

Комментарии

Примечание

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

Требования

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

См. также

Функции

Обзор

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList

SetupRemoveSectionFromDiskSpaceList