共用方式為


CM_Open_DevNode_Key函式 (cfgmgr32.h)

CM_Open_DevNode_Key函式會開啟裝置特定組態資訊的登錄機碼。

語法

CMAPI CONFIGRET CM_Open_DevNode_Key(
  [in]  DEVINST        dnDevNode,
  [in]  REGSAM         samDesired,
  [in]  ULONG          ulHardwareProfile,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDevice,
  [in]  ULONG          ulFlags
);

參數

[in] dnDevNode

系結至本機計算機的呼叫端提供的裝置實例句柄

[in] samDesired

要求之金鑰所需的登錄安全性存取。

[in] ulHardwareProfile

如果 ulFlags 包含CM_REGISTRY_CONFIG,要開啟的硬體配置檔。 如果此值為零,則會開啟目前硬體配置檔的索引鍵。

[in] Disposition

指定如何開啟登錄機碼。 可能是下列其中一個值:

RegDisposition_OpenAlways

如果金鑰存在,請開啟金鑰。 否則,請建立金鑰。

RegDisposition_OpenExisting

只有在金鑰存在時才開啟。

[out] phkDevice

HKEY 的指標,在成功時會收到已開啟的密鑰。

[in] ulFlags

開啟裝置節點金鑰旗標。 指出要開啟的登錄記憶體機碼範圍和類型。 可以是下列旗標的組合:

CM_REGISTRY_HARDWARE

開啟裝置的硬體金鑰。 請勿與CM_REGISTRY_SOFTWARE合併。

CM_REGISTRY_SOFTWARE

開啟裝置的軟體金鑰。 請勿與CM_REGISTRY_HARDWARE合併。

CM_REGISTRY_USER

開啟目前使用者的每個使用者金鑰。 請勿與CM_REGISTRY_CONFIG合併。

CM_REGISTRY_CONFIG

開啟儲存硬體配置檔特定組態資訊的金鑰。 請勿與CM_REGISTRY_USER合併。

傳回值

如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

備註

呼叫 RegCloseKey 以關閉從此函式傳回的句柄。

規格需求

需求
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 cfgmgr32.h (包含 Cfgmgr32.h)
程式庫 Cfgmgr32.lib;Windows 10 上的 OneCoreUAP.lib
Dll CfgMgr32.dll

另請參閱

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey