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 |