функция CM_Set_Class_PropertyW (cfgmgr32.h)

Статья
02/23/2024

Функция CM_Set_Class_Property задает свойство класса для класса настройки устройства или класса интерфейса устройства.

Синтаксис

CMAPI CONFIGRET CM_Set_Class_PropertyW(
  [in] LPCGUID          ClassGUID,
  [in] const DEVPROPKEY *PropertyKey,
  [in] DEVPROPTYPE      PropertyType,
  [in] const PBYTE      PropertyBuffer,
  [in] ULONG            PropertyBufferSize,
  [in] ULONG            ulFlags
);

Параметры

[in] ClassGUID

Указатель на GUID, который идентифицирует класс интерфейса устройства или класс настройки устройства , для которого нужно задать свойство устройства. Сведения об указании типа класса см. в параметре ulFlags .

[in] PropertyKey

Указатель на структуру DEVPROPKEY , представляющую ключ свойства класса устройства для задания.

[in] PropertyType

Значение типа DEVPROPTYPE, представляющее идентификатор типа property-data-type для свойства класса устройства. Чтобы удалить свойство, присвойте ей значение DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Указатель на буфер, содержащий значение свойства класса устройства. Если необходимо удалить свойство или данные, для этого указателя необходимо задать значение NULL, а свойствоBufferSize — нулевое значение.

[in] PropertyBufferSize

Размер буфера PropertyBuffer (в байтах). Если свойство PropertyBuffer имеет значение NULL, свойство 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.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Microsoft Windows Vista и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	cfgmgr32.h (включая Cfgmgr32.h)
Библиотека	Cfgmgr32.lib

См. также раздел

SetupDiSetClassProperty

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