CM_Open_Class_KeyA 函数 (cfgmgr32.h)

  • 项目

CM_Open_Class_Key 函数将打开设备安装程序类注册表项、设备接口类注册表项或类的特定子项。

语法

CMAPI CONFIGRET CM_Open_Class_KeyA(
  [in, optional] LPGUID         ClassGuid,
  [in, optional] LPCSTR         pszClassName,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkClass,
  [in]           ULONG          ulFlags
);

参数

[in, optional] ClassGuid

指向要打开其注册表项的类的 GUID 的指针。 此参数是可选的，可以为 NULL。 如果此参数为 NULL，则打开类树的根。

[in, optional] pszClassName

保留。 必须设置为 NULL。

[in] samDesired

要打开的密钥的注册表安全访问。

[in] Disposition

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

RegDisposition_OpenAlways

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

RegDisposition_OpenExisting

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

[out] phkClass

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

[in] ulFlags

打开类键标志：

CM_OPEN_CLASS_KEY_INSTALLER

要打开的密钥适用于设备安装类。

CM_OPEN_CLASS_KEY_INTERFACE

要打开的密钥适用于设备接口类。

返回值

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

注解

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

要求

要求 值
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 cfgmgr32.h (包括 Cfgmgr32.h)
Library Cfgmgr32.lib

另请参阅

CM_Delete_Class_Key
SetupDiOpenClassRegKeyEx