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

Статья
11/20/2024

Функция setupDiClassNameFromGuid извлекает имя класса, связанное с GUID класса.

Синтаксис

WINSETUPAPI BOOL SetupDiClassNameFromGuidA(
  [in]            const GUID *ClassGuid,
  [out]           PSTR       ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize
);

Параметры

[in] ClassGuid

Указатель на GUID класса для извлекаемого имени класса.

[out] ClassName

Указатель на буфер, получающий строку, завершающую значение NULL, которая содержит имя класса, указанного указателем в параметре ClassGuid.

[in] ClassNameSize

Размер буфера в символах, на который указывает параметр ClassName. Максимальный размер в символах имени класса, завершаемого значением NULL, является MAX_CLASS_NAME_LEN. Дополнительные сведения о размере имени класса см. в следующем разделе Примечания.

[out, optional] RequiredSize

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

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

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

Замечания

Вызовите SetupDiClassNameFromGuidEx, чтобы получить имя класса на удаленном компьютере.

SetupDiClassNameFromGuid не применяет ограничение длины имени класса, которое он может возвращать. Эта функция возвращает требуемый размер для имени класса, завершаемого значением NULL, даже если оно больше MAX_CLASS_NAME_LEN. Однако MAX_CLASS_NAME_LEN является максимальной длиной допустимого имени класса, завершаемого значением NULL. Вызывающий объект никогда не должен нуждаться в буфере, превышающем MAX_CLASS_NAME_LEN. Дополнительные сведения об именах классов см. в описании записи класса раздела INF Version.

Заметка

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

Требования

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

См. также

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx

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