CRegKey クラス

このクラスには、システム レジストリ内のエントリを操作するためのメソッドが用意されています。

重要
このクラスおよびメンバーは、Windows のランタイムで実行するアプリケーションで使用することはできません。

class CRegKey

メンバー

パブリック コンストラクター

名前	説明
CRegKey::CRegKey	コンストラクターです。
CRegKey::~CRegKey	デストラクターです。

パブリック メソッド

名前	説明
CRegKey::Attach	m_hKey メンバー ハンドルの値に hKey を設定して、HKEY を CRegKey オブジェクトに結び付けます。
CRegKey::Close	m_hKey メンバー ハンドルを解放し、このメンバー ハンドルの値に NULL を設定します。
CRegKey::Create	指定されたキーが hKeyParent のサブキーとして存在しない場合は、そのキーを作成します。
CRegKey::DeleteSubKey	指定されたキーをレジストリから削除します。
CRegKey::DeleteValue	m_hKey から値フィールドを削除します。
CRegKey::Detach	CRegKey オブジェクトから m_hKey メンバー ハンドルを切り離し、m_hKey の値に NULL を設定します。
CRegKey::EnumKey	開いているレジストリ キーのサブキーを列挙します。
CRegKey::Flush	開いているレジストリ キーのすべての属性をレジストリに書き込みます。
CRegKey::GetKeySecurity	開いているレジストリ キーを保護しているセキュリティ記述子のコピーを取得します。
CRegKey::NotifyChangeKeyValue	開いているレジストリ キーの属性や内容の変更について、呼び出し元に通知します。
CRegKey::Open	指定されたキーを開き、m_hKey の値にこのキーのハンドルを設定します。
CRegKey::QueryBinaryValue	指定された値名のバイナリ データを取得します。
CRegKey::QueryDWORDValue	指定された値名の DWORD データを取得します。
CRegKey::QueryGUIDValue	指定された値名の GUID データを取得します。
CRegKey::QueryMultiStringValue	指定された値名の複数文字列データを取得します。
CRegKey::QueryQWORDValue	指定された値名の QWORD データを取得します。
CRegKey::QueryStringValue	指定された値名の文字列データを取得します。
CRegKey::QueryValue	m_hKey の値フィールドのうち、指定された値フィールドのデータを取得します。以前のバージョンのこのメソッドはサポートされず、ATL_DEPRECATED のマークが付いています。
CRegKey::RecurseDeleteKey	指定されたキーをレジストリから削除し、サブキーがあればそれも削除します。
CRegKey::SetBinaryValue	レジストリ キーのバイナリ値を設定します。
CRegKey::SetDWORDValue	レジストリ キーの DWORD 値を設定します。
CRegKey::SetGUIDValue	レジストリ キーの GUID 値を設定します。
CRegKey::SetKeySecurity	レジストリ キーのセキュリティを設定します。
CRegKey::SetKeyValue	指定されたキーの指定された値フィールドにデータを格納します。
CRegKey::SetMultiStringValue	レジストリ キーの複数文字列値を設定します。
CRegKey::SetQWORDValue	レジストリ キーの QWORD 値を設定します。
CRegKey::SetStringValue	レジストリ キーの文字列値を設定します。
CRegKey::SetValue	m_hKey の指定された値フィールドにデータを格納します。以前のバージョンのこのメソッドはサポートされず、ATL_DEPRECATED のマークが付いています。

パブリック演算子

名前	説明
CRegKey::operator HKEY	CRegKey オブジェクトを HKEY に変換します。
CRegKey::operator =	代入演算子。

パブリック データ メンバー

名前	説明
CRegKey::m_hKey	CRegKey オブジェクトに関連付けられたレジストリ キーのハンドルを保持します。
CRegKey::m_pTM	CAtlTransactionManager のオブジェクトへのポインター。

解説

CRegKey には、システム レジストリのキーと値を作成および削除するメソッドを提供します。レジストリにインストールされた一連のインストールされているハードウェアのソフトウェア バージョン番号、論理的に物理的な割り当て、および COM オブジェクトなどのシステム コンポーネントの定義が含まれます。

CRegKey は、特定のコンピューターにレジストリにプログラミング インターフェイスを提供します。たとえば、特定のレジストリ キーを開くには、呼び出し CRegKey::Open。データ値、呼び出し CRegKey::QueryValue または CRegKey::SetValueを変更する取得や、それぞれ。キーを閉じるには、CRegKey::Closeを呼び出します。

キーを閉じると、レジストリ データは、ハード ディスクにフラッシュ書き込まれます。この処理には数秒かかることがあります。アプリケーションがハード ディスクに明示的にレジストリ データを記述する RegFlushKey Win32 の関数を呼び出すことができます。ただし、RegFlushKey は絶対に必要な場合に限り多くのシステム リソースを使用し、呼び出す必要があります。

セキュリティに関するメモ
呼び出し元がレジストリの場所を指定できるようにするメソッドは信頼できないデータを読み取る可能性があります。RegQueryValueEx を利用するメソッドは、この関数を明示的に終了する null である文字列を処理しないことを考慮に入れる必要があります。両方の条件を呼び出し元のコードからのチェックする必要があります。

必要条件

atlbase.hHeader:

参照

関連項目

Registry Overview

Registry Functions

Registry Value Types

概念

DCOM のサンプル

その他の技術情報

ATL クラスの概要