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 中使用。 |
| 目標平台 | DesktopFor universal， call CM_Open_Device_Interface_Key |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |