SetupDiOpenDevRegKey 函式 (setupapi.h)

發行項
08/26/2023

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 版)