SetupDiOpenDevRegKey 函数 (setupapi.h)

项目
08/26/2023

SetupDiOpenDevRegKey 函数为特定于设备的配置信息打开注册表项。

语法

WINSETUPAPI HKEY SetupDiOpenDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType,
  [in] REGSAM           samDesired
);

参数

[in] DeviceInfoSet

设备信息集的句柄，其中包含表示要为其打开注册表项的设备的设备信息元素。

[in] DeviceInfoData

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

[in] Scope

要打开的注册表项的范围。范围确定信息的存储位置。范围可以是全局的，也可以特定于硬件配置文件。范围由以下值之一指定：

DICS_FLAG_GLOBAL

打开密钥以存储全局配置信息。此信息并非特定于特定硬件配置文件。这会打开根位于 HKEY_LOCAL_MACHINE 的密钥。打开的确切键取决于 KeyType 参数的值。

DICS_FLAG_CONFIGSPECIFIC

打开密钥以存储特定于硬件配置文件的配置信息。此密钥根植于硬件配置文件特定的分支之一，而不是 HKEY_LOCAL_MACHINE。打开的确切键取决于 KeyType 参数的值。

[in] HwProfile

硬件配置文件值，设置如下：

如果 Scope 设置为 DICS_FLAG_CONFIGSPECIFIC， 则 HwProfile 将指定要打开的密钥的硬件配置文件。
如果 HwProfile 为 0，则会打开当前硬件配置文件的密钥。
如果DICS_FLAG_GLOBAL Scope ，则忽略 HwProfile 。

[in] KeyType

要打开的注册表存储密钥的类型，可以是以下值之一：

DIREG_DEV

打开设备的硬件密钥。

DIREG_DRV

打开设备的软件密钥。

有关设备的硬件和软件密钥的详细信息，请参阅设备和驱动程序的注册表树和密钥。

[in] samDesired

请求的密钥所需的注册表安全访问。有关 REGSAM 类型的注册表安全访问值的信息，请参阅Microsoft Windows SDK文档。

返回值

如果函数成功，它将返回打开的注册表项的句柄，可在其中存储/检索有关此设备实例的专用配置数据。

如果函数失败，它将返回INVALID_HANDLE_VALUE。要获得更多的错误信息，请调用 GetLastError。

注解

根据 samDesired 参数中传递的值，此函数的调用方可能需要成为 Administrators 组的成员。

通过调用 RegCloseKey 关闭从此函数返回的句柄。

在调用此函数之前，必须注册指定的设备实例。但是，请注意，操作系统会自动注册 PnP 设备实例。有关如何注册非 PnP 设备实例的信息，请参阅 SetupDiRegisterDeviceInfo。

要求


最低受支持的客户端	在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台	Desktop 要通用，请调用 CM_Open_DevNode_Key
标头	setupapi.h (包括 Setupapi.h)
Library	Setupapi.lib
DLL	Setupapi.dll
API 集	Windows 10版本 10.0.1439 (3 中引入的 ext-ms-win-setupapi-classinstallers-l1-1-2)