Функция SetupQueueDeleteW (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupQueueDelete помещает отдельную операцию удаления файла в очередь файлов установки.
Синтаксис
WINSETUPAPI BOOL SetupQueueDeleteW(
[in] HSPFILEQ QueueHandle,
[in] PCWSTR PathPart1,
[in] PCWSTR PathPart2
);
Параметры
[in] QueueHandle
Обработка очереди файлов установки, возвращенная setupOpenFileQueue.
[in] PathPart1
Указатель на строку, завершающуюся значением NULL, которая указывает первую часть пути к удаляемом файлу. Если PathPart2 имеет значение NULL, PathPart1 — это полный путь к удаляемом файлу.
[in] PathPart2
Указатель на строку, завершающуюся значением NULL, которая указывает вторую часть пути к удаляемом файлу. Этот параметр может иметь значение NULL. Он добавляется к PathPart1 , чтобы сформировать полный путь к удаляемом файлу. Функция проверяет и сворачивает повторяющиеся разделители пути при объединении PathPart1 и PathPart2.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ненулевым.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Так как предполагается, что операции удаления выполняются на фиксированном носителе, пользователю не будет предложено при фиксации очереди.
Примечание
Заголовок setupapi.h определяет SetupQueueDelete в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |