Функция SetupQueueDeleteSectionW (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupQueueDeleteSection помещает в очередь все файлы в разделе INF-файла для удаления. Раздел должен иметь правильный формат Delete Files , а INF-файл должен содержать раздел DestinationDirs .
Синтаксис
WINSETUPAPI BOOL SetupQueueDeleteSectionW(
[in] HSPFILEQ QueueHandle,
[in] HINF InfHandle,
[in] HINF ListInfHandle,
[in] PCWSTR 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 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |