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

Функция CM_Set_Class_Registry_PropertyA (cfgmgr32.h)

  • Статья

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

Синтаксис

CMAPI CONFIGRET CM_Set_Class_Registry_PropertyA(
  [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 необходимо задать нулевое значение.

Если для ulLength задано нулевое значение, функция удаляет свойство .

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

Требования

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

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

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty