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 |