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

Статья
02/23/2024

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

Синтаксис

CMAPI CONFIGRET CM_Set_Class_Registry_PropertyW(
  [in]           LPGUID   ClassGuid,
  [in]           ULONG    ulProperty,
  [in, optional] PCVOID   Buffer,
  [in]           ULONG    ulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Параметры

[in] ClassGuid

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

[in] ulProperty

Значение типа ULONG, определяющее свойство для задания. Это значение должно быть одним из значений CM_CRP_Xxx , описанных для параметра ulProperty функции CM_Get_Class_Registry_Property .

[in, optional] Buffer

Указатель на буфер, содержащий данные свойства. Этот параметр является необязательным и может иметь значение NULL. Дополнительные сведения о настройке этого параметра и соответствующего параметра ulLength см. в следующем разделе Примечаний .

[in] ulLength

Значение типа ULONG, указывающее размер данных свойства в байтах.

[in] ulFlags

Зарезервировано только для внутреннего использования. Необходимо задать нулевое значение.

[in, optional] hMachine

Дескриптор удаленного компьютера, на котором необходимо задать указанное свойство класса установки устройства. Этот параметр является необязательным. Если задано значение NULL, свойство устанавливается на локальном компьютере.

Возвращаемое значение

Если операция выполнена успешно, CM_Set_Class_Registry_Property возвращает CR_SUCCESS. В противном случае функция возвращает один из других кодов состояния CR_Xxx , определенных в Cfgmgr32.h.

Если для buffer не задано значение NULL , а значение ulLength не равно нулю, указанное значение должно иметь правильный размер для типа данных REG_Xxx для свойства, указанного в ulProperty.

Требования

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

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

CM_Get_Class_Registry_Property

SetupDiGetClassRegistryProperty

SetupDiSetClassRegistryProperty

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