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 を呼び出して、この関数から返されたハンドルを閉じます。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	cfgmgr32.h (Cfgmgr32.h を含む)
Library	Cfgmgr32.lib

こちらもご覧ください

CM_Delete_Class_Key
SetupDiOpenClassRegKeyEx