SetupDiDeleteDevRegKey 函数 (setupapi.h)

项目
08/26/2023

SetupDiDeleteDevRegKey 函数删除与设备信息元素关联的指定用户可访问的注册表项。

语法

WINSETUPAPI BOOL SetupDiDeleteDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType
);

参数

[in] DeviceInfoSet

设备信息集的句柄，其中包含表示要删除其注册表项的设备的设备信息元素。设备信息集不得包含远程元素。

[in] DeviceInfoData

指向 SP_DEVINFO_DATA 结构的指针，该结构指定 DeviceInfoSet 中的设备信息元素。

[in] Scope

要删除的注册表项的范围。范围指示信息所在的位置。密钥可以是全局或特定于硬件配置文件的。可以是以下其中一个值：

DICS_FLAG_GLOBAL

删除存储全局配置信息的密钥。

DICS_FLAG_CONFIGSPECIFIC

删除存储特定于硬件配置文件的配置信息的密钥。

[in] HwProfile

如果 Scope 设置为 DICS_FLAG_CONFIGSPECIFIC， 则 HwProfile 参数将指定要删除其注册表项的硬件配置文件。如果 HwProfile 为 0，则删除当前硬件配置文件的密钥。如果 HwProfile 是0xFFFFFFFF，则会删除所有硬件配置文件的注册表项。

[in] KeyType

要删除的注册表存储密钥的类型。可以是以下其中一个值：

DIREG_DEV

删除设备的硬件密钥。

DIREG_DRV

删除设备的软件密钥。

DIREG_BOTH

删除设备的硬件和软件密钥。

返回值

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

注解

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

DeviceInfoSet 只能包含本地计算机上的元素。

要求


最低受支持的客户端	在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台	桌面
标头	setupapi.h (包括 Setupapi.h)
Library	Setupapi.lib
DLL	Setupapi.dll

另请参阅

SetupDiCreateDevRegKey

SetupDiGetHwProfileList

通过