CM_Open_DevNode_Key 函数 (cfgmgr32.h)

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

语法

CMAPI CONFIGRET CM_Open_DevNode_Key(
  [in]  DEVINST        dnDevNode,
  [in]  REGSAM         samDesired,
  [in]  ULONG          ulHardwareProfile,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDevice,
  [in]  ULONG          ulFlags
);

参数

[in] dnDevNode

绑定到本地计算机的调用方提供的设备实例句柄

[in] samDesired

请求的密钥所需的注册表安全访问。

[in] ulHardwareProfile

如果 ulFlags 包含CM_REGISTRY_CONFIG,则打开的硬件配置文件。 如果此值为零,则打开当前硬件配置文件的键。

[in] Disposition

指定如何打开注册表项。 可以是以下值之一:

RegDisposition_OpenAlways

打开密钥(如果存在)。 否则,请创建密钥。

RegDisposition_OpenExisting

仅当密钥存在时才打开它。

[out] phkDevice

指向 HKEY 的指针,该 HKEY 将在成功后接收打开的密钥。

[in] ulFlags

打开设备节点密钥标志。 指示要打开的注册表存储密钥的范围和类型。 可以是以下标志的组合:

CM_REGISTRY_HARDWARE

打开设备的硬件密钥。 请勿与CM_REGISTRY_SOFTWARE结合使用。

CM_REGISTRY_SOFTWARE

打开设备的软件密钥。 请勿与CM_REGISTRY_HARDWARE结合使用。

CM_REGISTRY_USER

打开当前用户的按用户密钥。 请勿与CM_REGISTRY_CONFIG结合使用。

CM_REGISTRY_CONFIG

打开存储特定于硬件配置文件的配置信息的密钥。 请勿与CM_REGISTRY_USER结合使用。

返回值

如果操作成功,函数将返回CR_SUCCESS。 否则,它将返回 Cfgmgr32.h 中定义的CR_前缀错误代码之一。

注解

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

要求

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

另请参阅

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey