CRegKey クラス
このクラスには、システム レジストリ内のエントリを操作するためのメソッドが用意されています。
.gif "重要 :") 重要 |
|---|
このクラスおよびメンバーは、Windows のランタイムで実行するアプリケーションで使用することはできません。 |
class CRegKey
メンバー
.gif "xka57xy4.collapse_all(ja-jp,VS.110).gif")
パブリック コンストラクター
名前 |
説明 |
|---|---|
コンストラクターです。 |
|
デストラクターです。 |
パブリック メソッド
名前 |
説明 |
|---|---|
m_hKey メンバー ハンドルの値に hKey を設定して、HKEY を CRegKey オブジェクトに結び付けます。 |
|
m_hKey メンバー ハンドルを解放し、このメンバー ハンドルの値に NULL を設定します。 |
|
指定されたキーが hKeyParent のサブキーとして存在しない場合は、そのキーを作成します。 |
|
指定されたキーをレジストリから削除します。 |
|
m_hKey から値フィールドを削除します。 |
|
CRegKey オブジェクトから m_hKey メンバー ハンドルを切り離し、m_hKey の値に NULL を設定します。 |
|
開いているレジストリ キーのサブキーを列挙します。 |
|
開いているレジストリ キーのすべての属性をレジストリに書き込みます。 |
|
開いているレジストリ キーを保護しているセキュリティ記述子のコピーを取得します。 |
|
開いているレジストリ キーの属性や内容の変更について、呼び出し元に通知します。 |
|
指定されたキーを開き、m_hKey の値にこのキーのハンドルを設定します。 |
|
指定された値名のバイナリ データを取得します。 |
|
指定された値名の DWORD データを取得します。 |
|
指定された値名の GUID データを取得します。 |
|
指定された値名の複数文字列データを取得します。 |
|
指定された値名の QWORD データを取得します。 |
|
指定された値名の文字列データを取得します。 |
|
m_hKey の値フィールドのうち、指定された値フィールドのデータを取得します。以前のバージョンのこのメソッドはサポートされず、ATL_DEPRECATED のマークが付いています。 |
|
指定されたキーをレジストリから削除し、サブキーがあればそれも削除します。 |
|
レジストリ キーのバイナリ値を設定します。 |
|
レジストリ キーの DWORD 値を設定します。 |
|
レジストリ キーの GUID 値を設定します。 |
|
レジストリ キーのセキュリティを設定します。 |
|
指定されたキーの指定された値フィールドにデータを格納します。 |
|
レジストリ キーの複数文字列値を設定します。 |
|
レジストリ キーの QWORD 値を設定します。 |
|
レジストリ キーの文字列値を設定します。 |
|
m_hKey の指定された値フィールドにデータを格納します。以前のバージョンのこのメソッドはサポートされず、ATL_DEPRECATED のマークが付いています。 |
パブリック演算子
名前 |
説明 |
|---|---|
CRegKey オブジェクトを HKEY に変換します。 |
|
代入演算子。 |
パブリック データ メンバー
名前 |
説明 |
|---|---|
CRegKey オブジェクトに関連付けられたレジストリ キーのハンドルを保持します。 |
|
CAtlTransactionManager のオブジェクトへのポインター。 |
解説
CRegKey には、システム レジストリのキーと値を作成および削除するメソッドを提供します。レジストリにインストールされた一連のインストールされているハードウェアのソフトウェア バージョン番号、論理的に物理的な割り当て、および COM オブジェクトなどのシステム コンポーネントの定義が含まれます。
CRegKey は、特定のコンピューターにレジストリにプログラミング インターフェイスを提供します。たとえば、特定のレジストリ キーを開くには、呼び出し CRegKey::Open。データ値、呼び出し CRegKey::QueryValue または CRegKey::SetValueを変更する取得や、それぞれ。キーを閉じるには、CRegKey::Closeを呼び出します。
キーを閉じると、レジストリ データは、ハード ディスクにフラッシュ書き込まれます。この処理には数秒かかることがあります。アプリケーションがハード ディスクに明示的にレジストリ データを記述する RegFlushKey Win32 の関数を呼び出すことができます。ただし、RegFlushKey は絶対に必要な場合に限り多くのシステム リソースを使用し、呼び出す必要があります。
.gif "セキュリティに関するメモ") セキュリティに関するメモ |
|---|
呼び出し元がレジストリの場所を指定できるようにするメソッドは信頼できないデータを読み取る可能性があります。RegQueryValueEx を利用するメソッドは、この関数を明示的に終了する null である文字列を処理しないことを考慮に入れる必要があります。両方の条件を呼び出し元のコードからのチェックする必要があります。 |
必要条件
atlbase.hHeader: