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 状态代码之一。

注解

如果 BufferNULL,则必须将 ulLength 设置为零。

如果 ulLength 设置为零,则 函数将删除 属性。

如果 Buffer 未设置为 NULLulLength 未设置为零,则提供的值必须为 ulProperty 中指定的属性的 REG_Xxx 数据类型的正确大小。

要求

要求
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 通用
标头 cfgmgr32.h (包括 Cfgmgr32.h)
Library Cfgmgr32.lib

另请参阅

CM_Get_Class_Registry_Property

SetupDiGetClassRegistryProperty

SetupDiSetClassRegistryProperty