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

Статья
03/01/2024

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

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

Синтаксис

WINSETUPAPI BOOL SetupSetSourceListW(
  [in] DWORD  Flags,
  [in] PCWSTR *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 [только классические приложения]
Целевая платформа	Windows
Header	setupapi.h
Библиотека	Setupapi.lib
DLL	Setupapi.dll