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

Статья
11/20/2024

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll