CM_Open_Class_KeyA函式 (cfgmgr32.h)

發行項
02/23/2024

CM_Open_Class_Key函式會開啟裝置安裝類別登錄機碼、裝置介面類別登錄機碼或類別的特定子機碼。

語法

CMAPI CONFIGRET CM_Open_Class_KeyA(
  [in, optional] LPGUID         ClassGuid,
  [in, optional] LPCSTR         pszClassName,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkClass,
  [in]           ULONG          ulFlags
);

參數

[in, optional] ClassGuid

要開啟其登錄機碼之類別的 GUID 指標。此參數是選擇性的，可以是 NULL。如果此參數為 NULL，則會開啟類別樹狀結構的根目錄。

[in, optional] pszClassName

保留的。必須設定為 NULL。

[in] samDesired

要開啟之金鑰的登錄安全性存取。

[in] Disposition

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

RegDisposition_OpenAlways

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

RegDisposition_OpenExisting

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

[out] phkClass

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

[in] ulFlags

開啟類別索引鍵旗標：

CM_OPEN_CLASS_KEY_INSTALLER

要開啟的金鑰適用於裝置設定類別。

CM_OPEN_CLASS_KEY_INTERFACE

要開啟的金鑰適用於裝置介面類別。

傳回值

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

備註

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

規格需求

需求	值
最低支援的用戶端	可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台	桌面
標頭	cfgmgr32.h (包含 Cfgmgr32.h)
程式庫	Cfgmgr32.lib

另請參閱

CM_Delete_Class_Key
SetupDiOpenClassRegKeyEx

共用方式為