CM_Open_Class_KeyA函式 (cfgmgr32.h)

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 以關閉從此函式傳回的句柄。

規格需求

另請參閱

CM_Delete_Class_Key
SetupDiOpenClassRegKeyEx