функция CM_Get_Class_PropertyW (cfgmgr32.h)
Функция CM_Get_Class_Property извлекает свойство устройства, заданное для класса интерфейса устройства или класса настройки устройства.
Синтаксис
CMAPI CONFIGRET CM_Get_Class_PropertyW(
[in] LPCGUID ClassGUID,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags
);
Параметры
[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 извлекает запрошенное значение свойства, только если буфер достаточно велик для хранения всех данных значения свойства. Указатель может иметь значение NULL.
[in, out] PropertyBufferSize
Размер буфера PropertyBuffer (в байтах). Если параметру PropertyBuffer присвоено значение NULL, параметру *PropertyBufferSize необходимо задать нулевое значение. В качестве выходных данных, если буфер недостаточно велик для хранения всех данных значения свойства, CM_Get_Class_Property возвращает размер данных в байтах в *PropertyBufferSize.
[in] ulFlags
Флаги свойств класса:
CM_CLASS_PROPERTY_INSTALLER
ClassGUID указывает класс настройки устройства. Не сочетайте с CM_CLASS_PROPERTY_INTERFACE.
CM_CLASS_PROPERTY_INTERFACE
ClassGUID указывает класс интерфейса устройства. Не сочетайте с CM_CLASS_PROPERTY_INSTALLER.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.
Комментарии
CM_Get_Class_Property является частью единой модели свойств устройства.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows Vista и более поздних версиях Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib |