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

Статья
11/20/2024

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

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

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

Синтаксис

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 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll

См. также

Функции

Обзор

SetupRemoveFromSourceList

SetupSetSourceList

Поделиться через