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

Статья
11/20/2024

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

Функция setupQueueDeleteSection setupQueueDeleteSection помещает все файлы в раздел INF-файла для удаления. Раздел должен находиться в правильном формате удалить файлы, а INF-файл должен содержать раздел DestinationDirs.

Синтаксис

WINSETUPAPI BOOL SetupQueueDeleteSectionA(
  [in] HSPFILEQ QueueHandle,
  [in] HINF     InfHandle,
  [in] HINF     ListInfHandle,
  [in] PCSTR    Section
);

Параметры

[in] QueueHandle

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

[in] InfHandle

Обработайте открытый INF-файл, содержащий раздел DestinationDirs. Если ListInfHandle не указан, InfHandle содержит имя раздела.

[in] ListInfHandle

Необязательный дескриптор открытого INF-файла, содержащего раздел для удаления. Если ListInfHandle не указано, предполагается, что InfHandle содержит имя раздела.

[in] Section

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

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

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

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

Замечания

Для этой функции требуется INF-файл Windows. Некоторые старые форматы INF-файлов могут не поддерживаться.

Заметка

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

Требования

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

См. также

Функции

Обзор

SetupQueueCopySection

SetupQueueDelete

SetupQueueRenameSection

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