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

Статья
11/20/2024

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

Функция setupQueueDelete помещает отдельную операцию удаления файлов в очередь файла установки.

Синтаксис

WINSETUPAPI BOOL SetupQueueDeleteA(
  [in] HSPFILEQ QueueHandle,
  [in] PCSTR    PathPart1,
  [in] PCSTR    PathPart2
);

Параметры

[in] QueueHandle

Обработайте очередь файла установки, как возвращается SetupOpenFileQueue.

[in] PathPart1

Указатель на строку null-terminated, которая указывает первую часть пути к удалению файла. Если PathPart2NULL, PathPart1 является полным путем удаления файла.

[in] PathPart2

Указатель на строку null-terminated, которая указывает вторую часть пути к удалению файла. Этот параметр может быть null. Это добавляется к PathPart1, чтобы сформировать полный путь к файлу для удаления. Функция проверяет наличие и свертывает повторяющиеся разделители путей при объединении PathPart1 и PathPart2.

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

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

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

Замечания

Так как предполагается, что операции удаления выполняются на фиксированных носителях, пользователь не будет запрашивать при фиксации очереди.

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupQueueCopy

SetupQueueDeleteSection

SetupQueueRename

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