CM_Open_Device_Interface_Key_ExA函式 (cfgmgr32.h)
[從 Windows 8 和 Windows Server 2012 開始,此函式已被取代。 請改用 CM_Open_Device_Interface_Key 。]
CM_Open_Device_Interface_Key_ExA函式會開啟應用程式和驅動程式用來儲存裝置介面專屬信息的登錄子機碼。
語法
CMAPI CONFIGRET CM_Open_Device_Interface_Key_ExA(
[in] LPCSTR pszDeviceInterface,
[in] REGSAM samDesired,
[in] REGDISPOSITION Disposition,
[out] PHKEY phkDeviceInterface,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
參數
[in] pszDeviceInterface
字串的指標,識別要開啟登錄子機碼的裝置介面實例。
[in] samDesired
登錄子機碼的要求登錄安全性存取權。
[in] Disposition
指定如何開啟登錄機碼。 可能是下列其中一個值:
RegDisposition_OpenAlways
如果金鑰存在,請開啟金鑰。 否則,請建立金鑰。
RegDisposition_OpenExisting
只有在金鑰存在時才開啟。
[out] phkDeviceInterface
HKEY 的指標,在成功時會收到已開啟的密鑰。
[in] ulFlags
保留的。 必須設定為零。
[in, optional] hMachine
呼叫端提供的機器句柄,是從先前呼叫取得 來CM_Connect_Machine。
注意從 Windows 8 和 Windows Server 2012 開始,不支援使用此函式來存取遠端計算機,因為此功能已移除。
傳回值
如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。
備註
呼叫 RegCloseKey 以關閉從此函式傳回的句柄。
注意
cfgmgr32.h 標頭會將CM_Open_Device_Interface_Key_Ex定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Microsoft Windows 10 及更新版本的 Windows 中使用。 |
目標平台 | 桌面 |
標頭 | cfgmgr32.h (包含 Cfgmgr32.h) |
程式庫 | Cfgmgr32.lib |