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