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

Статья
08/26/2023

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

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

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

Синтаксис

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

Параметры

[in] Flags

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

SRCLIST_SYSTEM

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

SRCLIST_USER

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

SRCLIST_SYSIFADMIN

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

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

SRCLIST_APPEND

Добавьте источник в конец списка. Если этот флаг не указан, источник добавляется в начало списка.

[in] Source

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

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

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

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

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

Требования


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