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 |