функция CM_Get_DevNode_PropertyW (cfgmgr32.h)
Функция CM_Get_DevNode_Property извлекает свойство экземпляра устройства.
Синтаксис
CMAPI CONFIGRET CM_Get_DevNode_PropertyW(
[in] DEVINST dnDevInst,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags
);
Параметры
[in] dnDevInst
Дескриптор экземпляра устройства, привязанный к локальному компьютеру.
[in] PropertyKey
Указатель на структуру DEVPROPKEY , представляющую ключ свойства устройства запрошенного свойства экземпляра устройства.
[out] PropertyType
Указатель на переменную типа DEVPROPTYPE, которая получает идентификатор типа property-data-type запрошенного свойства экземпляра устройства, где идентификатор property-data-type представляет собой побитовое ЗНАЧЕНИЕ OR между идентификатором типа base-data-type и модификатором property-data-type, если базовый тип данных изменен.
[out] PropertyBuffer
Указатель на буфер, который получает свойство запрошенного экземпляра устройства. CM_Get_DevNode_Property извлекает запрошенное свойство только в том случае, если буфер достаточно велик для хранения всех данных о значении свойства. Указатель может иметь значение NULL.
[in, out] PropertyBufferSize
Размер буфера PropertyBuffer (в байтах). Если свойство PropertyBuffer имеет значение NULL, параметру *PropertyBufferSize необходимо задать нулевое значение. В качестве выходных данных, если буфер недостаточно велик для хранения всех данных значения свойства, CM_Get_DevNode_Property возвращает размер данных в байтах в *PropertyBufferSize.
[in] ulFlags
Зарезервировано. Необходимо задать нулевое значение.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.
Комментарии
CM_Get_DevNode_Property является частью единой модели свойств устройства.
Требования
Минимальная версия клиента | Доступно в Microsoft Windows Vista и более поздних версиях Windows. |
Целевая платформа | Универсальное |
Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
Библиотека | Cfgmgr32.lib |
DLL | CfgMgr32.dll |