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

SetupDiGetClassRegistryProperty

SetupDiSetClassRegistryProperty