CM_Open_Device_Interface_KeyW 函数 (cfgmgr32.h)

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

语法

CMAPI CONFIGRET CM_Open_Device_Interface_KeyW(
  [in]  LPCWSTR        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)
Library Cfgmgr32.lib

另请参阅

SetupDiOpenDeviceInterfaceRegKey