Функция SetupRemoveFromSourceListA (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]
Функция SetupRemoveFromSourceList удаляет значение из списка источников установки для текущего пользователя или системы. Списки систем и пользователей объединяются во время выполнения.
Вызывающий объект этой функции требуется иметь права администратора, в противном случае функция завершается ошибкой.
Синтаксис
WINSETUPAPI BOOL SetupRemoveFromSourceListA(
[in] DWORD Flags,
[in] PCSTR Source
);
Параметры
[in] Flags
Указывает источник, который нужно удалить из списка. Этот параметр может быть любым сочетанием следующих значений.
SRCLIST_SYSTEM
Удалите источник в список для каждой системы. Вызывающий объект должен быть администратором.
SRCLIST_USER
Удалите источник в список пользователей.
SRCLIST_SYSIFADMIN
Если вызывающий объект является администратором, источник удаляется из списка каждой системы; Если вызывающий объект не является администратором, источник удаляется из списка пользователей для текущего пользователя.
SRCLIST_SUBDIRS
Удалите все подкаталоги источника.
[in] Source
Указатель на строку, завершающуюся значением NULL, которая указывает источник для удаления из списка.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение является ненулевое значение.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Заметка
Заголовок setupapi.h определяет SetupRemoveFromSourceList как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | setupapi.h |
| библиотеки |
Setupapi.lib |
| DLL | Setupapi.dll |
См. также
Обзор