SetupDiSetClassRegistryPropertyA 函数 (setupapi.h)

项目
03/05/2024

SetupDiSetClassRegistryProperty 函数在注册表中设置指定的设备类属性。

语法

WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyA(
  [in]           const GUID *ClassGuid,
  [in]           DWORD      Property,
  [in, optional] const BYTE *PropertyBuffer,
  [in]           DWORD      PropertyBufferSize,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

参数

[in] ClassGuid

指向 GUID 的指针，用于标识要为其设置属性的设备类。

[in] Property

一个值，该值标识要设置的属性，该属性必须是下列属性之一：

SPCRP_CHARACTERISTICS

调用方提供指定类的设备特征的标志。有关特征标志的列表，请参阅 IoCreateDevice 的 DeviceCharacteristics 参数。应在安装设备类时设置设备特征，在安装设备类后不应更改设备特征。

SPCRP_DEVTYPE

调用方提供类的设备类型。有关详细信息，请参阅指定设备类型。安装设备类时应设置设备类型，安装设备类后不应更改设备类型。

SPCRP_EXCLUSIVE

调用方提供一个 DWORD 值，该值指定用户是否可以获得对此类设备的独占访问权限。如果允许独占访问，则提供的值为 1，否则为零。设备的独占设置应在安装设备类时设置，在安装设备类后不应更改。

SPCRP_LOWERFILTERS

(Windows Vista 及更高版本) 调用方提供为设备安装类安装的较低筛选器驱动程序的服务名称REG_MULTI_SZ列表。有关如何安装类筛选器驱动程序的详细信息，请参阅安装筛选器驱动程序和 INF ClassInstall32 部分。

SPCRP_SECURITY

调用方以自相关格式提供设备的安全描述符作为SECURITY_DESCRIPTOR结构， (Microsoft Windows SDK文档) 中所述。

SPCRP_SECURITY_SDS

调用方将设备的安全描述符作为文本字符串提供。有关安全描述符字符串的信息，请参阅安全描述符定义语言 (Windows) 。有关安全描述符字符串的格式的信息，请参阅安全描述符定义语言 (Windows) 。

SPCRP_UPPERFILTERS

(Windows Vista 及更高版本) 调用方提供为设备安装类安装的上层筛选器驱动程序的服务名称REG_MULTI_SZ列表。有关如何安装类筛选器驱动程序的详细信息，请参阅安装筛选器驱动程序和 INF ClassInstall32 部分。

[in, optional] PropertyBuffer

指向提供指定属性的缓冲区的指针。此参数是可选的，可以为 NULL。

[in] PropertyBufferSize

PropertyBuffer 缓冲区的大小（以字节为单位）。

[in, optional] MachineName

指向以 NULL 结尾的字符串的指针，该字符串包含要设置指定设备类属性的远程系统的名称。此参数是可选的，可以为 NULL。如果此参数为 NULL，则会在本地系统的名称上设置属性。

注意

从Windows 8和Windows Server 2012开始，不支持使用此函数访问远程计算机，因为此功能已被删除。

Reserved

保留的必须为 NULL。

返回值

如果成功，该函数将返回 TRUE 。否则，它将返回 FALSE ，并且可以通过调用 GetLastError 来检索记录的错误。

注解

此函数的调用方必须是管理员组的成员。

若要确定设备类属性的数据类型，请调用 SetupDiGetClassRegistryProperty。

注意

setupapi.h 标头将 SetupDiSetClassRegistryProperty 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	在 Windows XP 和更高版本的 Windows 中可用。
目标平台	桌面
标头	setupapi.h (包括 Setupapi.h)
Library	Setupapi.lib

另请参阅

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetDeviceRegistryProperty

通过