функция CM_Set_Class_Registry_PropertyW (cfgmgr32.h)
Функция 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 должно быть равно нулю.
Если значение ulLength равно нулю, функция удаляет свойство .
Если для buffer не задано значение NULL , а значение ulLength не равно нулю, указанное значение должно иметь правильный размер для типа данных REG_Xxx для свойства, указанного в ulProperty.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib |
См. также раздел
CM_Get_Class_Registry_Property