CM_Open_DevNode_Key函式 (cfgmgr32.h)

發行項
02/26/2024

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

Share via