функция CM_Get_Class_Property_ExW (cfgmgr32.h)
[Начиная с Windows 8 и Windows Server 2012 эта функция устарела. Вместо этого используйте CM_Get_Class_Property .]
Функция CM_Get_Class_Property_ExW извлекает свойство устройства, заданное для класса интерфейса устройства или класса настройки устройства.
Синтаксис
CMAPI CONFIGRET CM_Get_Class_Property_ExW(
[in] LPCGUID ClassGUID,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags,
[in] HMACHINE hMachine
);
Параметры
[in] ClassGUID
Указатель на GUID, который идентифицирует класс интерфейса устройства или класс настройки устройства , для которого требуется получить свойство устройства, заданное для класса устройства. Сведения об указании типа класса см. в параметре ulFlags .
[in] PropertyKey
Указатель на структуру DEVPROPKEY , представляющую ключ свойства устройства запрошенного свойства класса устройства.
[out] PropertyType
Указатель на переменную типа DEVPROPTYPE, которая получает идентификатор типа property-data-type запрошенного свойства класса устройства, где идентификатор property-data-type представляет собой побитовое ЗНАЧЕНИЕ OR между идентификатором типа base-data-type и модификатор property-data-type, если базовый тип данных изменен.
[out] PropertyBuffer
Указатель на буфер, получающий запрошенное свойство класса устройства. CM_Get_Class_Property_ExW извлекает запрошенное значение свойства, только если буфер достаточно велик для хранения всех данных значения свойства. Указатель может иметь значение NULL.
[in, out] PropertyBufferSize
Размер буфера PropertyBuffer (в байтах). Если параметру PropertyBuffer присвоено значение NULL, параметру *PropertyBufferSize необходимо задать нулевое значение. В качестве выходных данных, если буфер недостаточно велик для хранения всех данных значения свойства, CM_Get_Class_Property_ExW возвращает размер данных в байтах в *PropertyBufferSize.
[in] ulFlags
Флаги свойств класса:
CM_CLASS_PROPERTY_INSTALLER
ClassGUID указывает класс настройки устройства. Не сочетайте с CM_CLASS_PROPERTY_INTERFACE.
CM_CLASS_PROPERTY_INTERFACE
ClassGUID указывает класс интерфейса устройства. Не сочетайте с CM_CLASS_PROPERTY_INSTALLER.
[in] hMachine
Дескриптор компьютера, предоставленный вызывающим абонентом, полученный при предыдущем вызове CM_Connect_Machine.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.
Комментарии
CM_Get_Class_Property_ExW является частью единой модели свойств устройства.
Требования
Минимальная версия клиента | Доступно в Microsoft Windows 10 и более поздних версиях Windows. |
Целевая платформа | Персональный компьютер |
Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
Библиотека | Cfgmgr32.lib |