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

Статья
08/26/2023

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

Функция SetupRemoveFromSourceList удаляет значение из списка источников установки для текущего пользователя или системы. Системные и пользовательские списки объединяются во время выполнения.

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

Синтаксис

WINSETUPAPI BOOL SetupRemoveFromSourceListA(
  [in] DWORD Flags,
  [in] PCSTR Source
);

Параметры

[in] Flags

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

SRCLIST_SYSTEM

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

SRCLIST_USER

Удалите источник в списке для каждого пользователя.

SRCLIST_SYSIFADMIN

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

Примечание Если в настоящее время используется временный список (см . раздел SetupSetSourceList), предыдущие флаги игнорируются, а источник удаляется из временного списка.

SRCLIST_SUBDIRS

Удалите все подкаталоги источника.

[in] Source

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

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

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

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

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

Требования

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