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 的指针,该 GUID 表示要为其设置属性的设备安装类。
[in] ulProperty
一个 ULONG 类型的值,该值标识要设置的属性。 此值必须是为 CM_Get_Class_Registry_Property 函数的 ulProperty 参数描述的 CM_CRP_Xxx 值之一。
[in, optional] Buffer
指向包含属性数据的缓冲区的指针。 此参数是可选的,可以设置为 NULL。 有关设置此参数和相应的 ulLength 参数的详细信息,请参阅以下 备注 部分。
[in] ulLength
类型为 ULONG 的值,该值指定属性数据的大小(以字节为单位)。
[in] ulFlags
保留以仅供内部使用。 必须设置为零。
[in, optional] hMachine
远程计算机的句柄,用于设置指定的 设备设置类属性。 此参数是可选的。 如果设置为 NULL,则在本地计算机上设置 属性。
返回值
如果操作成功, CM_Set_Class_Registry_Property 将返回CR_SUCCESS。 否则,该函数返回 Cfgmgr32.h 中定义的其他 CR_Xxx 状态代码之一。
注解
如果 Buffer 为 NULL,则必须将 ulLength 设置为零。
如果 ulLength 设置为零,则 函数将删除 属性。
如果 Buffer 未设置为 NULL 且 ulLength 未设置为零,则提供的值必须为 ulProperty 中指定的属性的 REG_Xxx 数据类型的正确大小。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 通用 |
标头 | cfgmgr32.h (包括 Cfgmgr32.h) |
Library | Cfgmgr32.lib |
另请参阅
CM_Get_Class_Registry_Property