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

Статья
08/26/2023

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

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

Синтаксис

WINSETUPAPI BOOL SetupQuerySourceListA(
  [in]      DWORD Flags,
  [in, out] PCSTR **List,
  [in, out] PUINT Count
);

Параметры

[in] Flags

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

SRCLIST_SYSTEM

Запрос системного списка.

SRCLIST_USER

Запрос списка для каждого пользователя.

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

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

SRCLIST_NOSTRIPPLATFORM

Как правило, все пути удаляются от компонента конкретной платформы, если он является конечным компонентом. Например, путь, хранящийся в реестре как f:\x86, возвращается как f:. Если этот флаг указан, компонент, зависящий от платформы, не удаляется.

[in, out] List

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

[in, out] Count

Указатель на переменную, в которой эта функция возвращает количество источников в списке.

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

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

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

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

Требования

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