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

Статья
03/15/2023

Функция 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 (включая Setupapi.h)
Библиотека	Setupapi.lib

См. также раздел

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

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