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 |