共用方式為


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

另請參閱

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiGetHwProfileList

SetupDiRegisterDeviceInfo