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

Статья
11/20/2024

Функция SetupDiClassNameFromGuidEx извлекает имя класса, связанное с GUID класса. Класс можно установить на локальном или удаленном компьютере.

Синтаксис

WINSETUPAPI BOOL SetupDiClassNameFromGuidExA(
  [in]            const GUID *ClassGuid,
  [out]           PSTR       ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCSTR      MachineName,
                  PVOID      Reserved
);

Параметры

[in] ClassGuid

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

[out] ClassName

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

[in] ClassNameSize

Размер в символах буфера класса .

[out, optional] RequiredSize

Количество символов, необходимых для хранения имени класса (включая завершающий значение NULL). RequiredSize всегда меньше MAX_CLASS_NAME_LEN.

[in, optional] MachineName

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

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

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

Reserved

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

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

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

Замечания

Заметка

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

Требования

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

См. также

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid

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