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

SetupDiClassNameFromGuidA function (setupapi.h)

  • Статья

Функция 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.

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть setupapi.h (включая Setupapi.h)
Библиотека Setupapi.lib

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

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx