SetupDiOpenDevRegKey 函式 (setupapi.h)
SetupDiOpenDevRegKey函式會開啟裝置特定組態資訊的登錄機碼。
語法
WINSETUPAPI HKEY SetupDiOpenDevRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Scope,
[in] DWORD HwProfile,
[in] DWORD KeyType,
[in] REGSAM samDesired
);
參數
[in] DeviceInfoSet
裝置資訊集的控制碼，其中包含代表要開啟登錄機碼之裝置的裝置資訊專案。
[in] DeviceInfoData
SP_DEVINFO_DATA結構的指標，指定DeviceInfoSet中的裝置資訊專案。
[in] Scope
要開啟的登錄機碼範圍。 範圍會決定資訊儲存的位置。 範圍可以是全域或硬體設定檔特有的。 範圍是由下列其中一個值所指定：
DICS_FLAG_GLOBAL
開啟金鑰以儲存通用群組態資訊。 此資訊不是特定硬體設定檔特有的。 這會開啟以HKEY_LOCAL_MACHINE根目錄的金鑰 。 開啟的確切索引鍵取決於 KeyType 參數的值。
DICS_FLAG_CONFIGSPECIFIC
開啟金鑰以儲存硬體設定檔特定的組態資訊。 此金鑰是以其中一個硬體設定檔特定分支為根目錄，而不是 HKEY_LOCAL_MACHINE。 開啟的確切索引鍵取決於 KeyType 參數的值。
[in] HwProfile
硬體設定檔值，設定如下：
- 如果 Scope 設定為 DICS_FLAG_CONFIGSPECIFIC， HwProfile 會指定要開啟之金鑰的硬體設定檔。
- 如果 HwProfile 為 0，則會開啟目前硬體設定檔的金鑰。
- 如果 Scope 是DICS_FLAG_GLOBAL， 則會忽略 HwProfile 。
[in] KeyType
要開啟的登錄儲存體機碼類型，可以是下列其中一個值：
DIREG_DEV
開啟裝置 的硬體金鑰 。
DIREG_DRV
開啟裝置 的軟體金鑰 。
如需裝置硬體和軟體金鑰的詳細資訊，請參閱 裝置和驅動程式的登錄樹狀架構和機碼。
[in] samDesired
要求之金鑰所需的登錄安全性存取。 如需 REGSAM 類型登錄安全性存取值的相關資訊，請參閱Microsoft Windows SDK檔。
傳回值
如果函式成功，它會傳回已開啟登錄機碼的控制碼，其中可儲存/擷取此裝置實例的相關私用設定資料。
如果函式失敗，它會傳回INVALID_HANDLE_VALUE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
根據在 samDesired 參數中傳遞的值，此函式的呼叫端可能需要成為 Administrators 群組的成員。
呼叫 RegCloseKey，以關閉從此函式傳回的控制碼。
呼叫此函式之前，必須先註冊指定的裝置實例。 不過請注意，作業系統會自動註冊 PnP 裝置實例。 如需如何註冊非 PnP 裝置實例的資訊，請參閱 SetupDiRegisterDeviceInfo。
需求
| 最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
| 目標平台 | DesktopFor universal， call CM_Open_DevNode_Key |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |
| API 集合 | ext-ms-win-setupapi-classinstallers-l1-1-2 (于 Windows 10 10.0.14393 版) |