通过

CM_Open_Device_Interface_KeyA函数 （cfgmgr32.h）

  • 项目

CM_Open_Device_Interface_Key 函数将打开应用程序和驱动程序用来存储特定于设备接口的信息的注册表子项。

语法

CMAPI CONFIGRET CM_Open_Device_Interface_KeyA(
  [in]  LPCSTR         pszDeviceInterface,
  [in]  REGSAM         samDesired,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDeviceInterface,
  [in]  ULONG          ulFlags
);

参数

[in] pszDeviceInterface

指向标识要为其打开注册表子项的设备接口实例的字符串的指针。

[in] samDesired

请求的注册表安全访问注册表子项。

[in] Disposition

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

RegDisposition_OpenAlways

打开密钥（如果存在）。 否则，请创建密钥。

RegDisposition_OpenExisting

仅当密钥存在时，才打开该键。

[out] phkDeviceInterface

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

[in] ulFlags

保留。 必须设置为零。

返回值

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

言论

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

注意

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

要求

要求 价值
最低支持的客户端 Microsoft Windows Vista 和更高版本的 Windows 中可用。
目标平台 普遍
标头 cfgmgr32.h （包括 Cfgmgr32.h）
库 Cfgmgr32.lib

另请参阅

SetupDiOpenDeviceInterfaceRegKey