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