SetupDiOpenClassRegKey 函数 (setupapi.h)

SetupDiOpenClassRegKey 函数将打开安装程序类注册表项或特定类的子项。

语法

WINSETUPAPI HKEY SetupDiOpenClassRegKey(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired
);

[in, optional] ClassGuid

指向要打开其密钥的设置类的 GUID 的指针。此参数是可选的，可以为 NULL。如果此参数为 NULL，则打开安装程序类树 (HKLM\SYSTEM\CurrentControlSet\Control\Class) 的根目录。

[in] samDesired

要打开的密钥的注册表安全访问。有关 REGSAM 类型的注册表安全访问值的信息，请参阅Microsoft Windows SDK文档。

如果函数成功，它将返回打开的注册表项的句柄，可在其中存储/检索有关此设置类的信息。

如果该函数失败，它将返回INVALID_HANDLE_VALUE。要获得更多的错误信息，请调用 GetLastError。

根据 samDesired 参数中传递的值，此函数的调用方可能需要成为 Administrators 组的成员。

如果注册表项尚不存在，则此函数不会创建该注册表项。

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

若要打开接口类注册表项或特定接口类子项，请调用 SetupDiOpenClassRegKeyEx。

要求	值
最低受支持的客户端	在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台	桌面对于通用，请调用 CM_Open_Class_Key
标头	setupapi.h (包括 Setupapi.h)
Library	Setupapi.lib
DLL	Setupapi.dll