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

Статья
11/20/2024

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

См. также

Функции

Обзор

SetupSetSourceList

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