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

Статья
11/20/2024

Функция setupDiBuildClassInfoListEx возвращает список идентификаторов guid класса установки, который включает каждый класс, установленный в локальной системе или удаленной системе.

Синтаксис

WINSETUPAPI BOOL SetupDiBuildClassInfoListExA(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize,
  [in, optional]  PCSTR  MachineName,
                  PVOID  Reserved
);

Параметры

[in] Flags

Флаги, используемые для управления исключением классов из списка. Если флаги не указаны, все классы установки включены в список. Может быть сочетанием следующих значений:

DIBCI_NOINSTALLCLASS

Исключите класс, если у него есть запись NoInstallClass в своем разделе реестра.

DIBCI_NODISPLAYCLASS

Исключите класс, если у него есть запись значения NoDisplayClass в его разделе реестра.

[out, optional] ClassGuidList

Указатель на буфер, который получает список идентификаторов GUID класса установки.

[in] ClassGuidListSize

Предоставляет количество идентификаторов GUID в массиве ClassGuildList.

[out] RequiredSize

Указатель на переменную, которая получает число возвращаемых идентификаторов GUID. Если это число больше размера ClassGuidList, число указывает, насколько большой массив ClassGuidList должен содержать список.

[in, optional] MachineName

Указатель на строку, завершающую значение NULL, содержащую имя удаленного компьютера, с которого необходимо получить установленные классы установки. Этот параметр является необязательным и может быть null. Если MachineNameзначение NULL, эта функция создает список классов, установленных на локальном компьютере.

Осторожность

Эта функция для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.

Reserved

Должен быть null.

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

Функция возвращает TRUE, если она выполнена успешно. В противном случае возвращается FALSE и ошибка журнала может быть получена путем вызова GetLastError.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	setupapi.h (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

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