SetupDiOpenDeviceInterfaceRegKey 函数 (setupapi.h)

  • 项目

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

语法

WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved,
  [in] REGSAM                    samDesired
);

参数

[in] DeviceInfoSet

指向 设备信息集 的指针，该信息集包含要为其打开注册表子项的设备接口。

[in] DeviceInterfaceData

指向指定设备接口 的SP_DEVICE_INTERFACE_DATA 结构的指针。 此指针可由 SetupDiCreateDeviceInterface 或 SetupDiEnumDeviceInterfaces 返回。

Reserved

保留。 必须为零。

[in] samDesired

请求的注册表安全访问注册表子项。 有关 REGSAM 类型的注册表安全访问值的信息，请参阅Microsoft Windows SDK文档。

返回值

SetupDiOpenDeviceInterfaceRegKey 返回打开的注册表项的句柄。 如果该函数失败，它将返回INVALID_HANDLE_VALUE。 要获得更多的错误信息，请调用 GetLastError。

注解

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

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

要求

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

另请参阅

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces