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

Статья
11/20/2024

Функция setupDiClassGuidsFromNameEx извлекает идентификаторы GUID, связанные с указанным именем класса. В этом результирующем списке содержатся классы, установленные на локальном или удаленном компьютере.

Синтаксис

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

Параметры

[in] ClassName

Имя класса, для которого требуется получить идентификаторы GUID класса.

[out] ClassGuidList

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

[in] ClassGuidListSize

Количество идентификаторов GUID в массиве classGuidList .

[out] RequiredSize

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

[in, optional] MachineName

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

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

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

Reserved

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

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

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

Замечания

Имена классов не гарантируются уникальными; уникальны только идентификаторы GUID. Таким образом, одно имя класса может возвращать несколько GUID.

Заметка

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

Требования

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

См. также

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx

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