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

Статья
08/26/2023

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

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

Синтаксис

WINSETUPAPI BOOL SetupSetSourceListA(
  [in] DWORD Flags,
  [in] PCSTR *SourceList,
  [in] UINT  SourceCount
);

Параметры

[in] Flags

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

SRCLIST_SYSTEM

Список — это список последних использованных систем (MRU), хранящийся в реестре. Вызывающий объект должен быть членом локальной группы администраторов.

SRCLIST_USER

Список — это список mrU для каждого пользователя, хранящийся в реестре.

SRCLIST_TEMPORARY

Указанный список является временным и будет единственным списком, доступным для текущего процесса, пока не будет вызван SetupCancelTemporarySourceList или SetSourceList снова не будет вызван.

Важно Если задан временный список, источники не добавляются в системные или пользовательские списки и не удаляются из них, даже если последующие вызовы SetupAddToSourceList или SetupRemoveFromSourceList явно указывают эти списки.

Примечание Необходимо указать один из флагов SRCLIST_SYSTEM, SRCLIST_USER или SRCLIST_TEMPORARY.

SRCLIST_NOBROWSE

Пользователь не может добавлять или изменять источники при использовании SetupPromptForDisk . Этот флаг обычно используется в сочетании с флагом SRCLIST_TEMPORARY.

[in] SourceList

Указатель на массив строк для использования в качестве исходного списка, как указано в параметре Flags .

[in] SourceCount

Количество элементов в массиве, на который указывает SourceList.

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

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

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

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

Требования

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