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

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

  • Статья

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

Функция SetupQueueDeleteSection помещает в очередь все файлы в разделе INF-файла для удаления. Раздел должен иметь правильный формат Delete Files , а 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

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

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

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

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

Комментарии

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

Примечание

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

Требования

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

См. также

Функции

Обзор

SetupQueueCopySection

SetupQueueDelete

SetupQueueRenameSection