System.Win.Registry.TRegistry.CreateKey

Delphi

function CreateKey(const Key: string): Boolean;

C++

bool __fastcall CreateKey(const System::UnicodeString Key);

種類	可視性	ソース	ユニット	親
function	public	System.Win.Registry.pas System.Win.Registry.hpp	System.Win.Registry	TRegistry

説明

レジストリに新しいキーを作成します。

CreateKey を呼び出すと，新しいキーをレジストリに追加できます。Key は作成するキーの名前です。Key は絶対名でも相対名でもかまいません。絶対キーは円記号（\）で始まるルートキーのサブキーです。相対キーは現在のキーのサブキーです。

CreateKey はキーが正しく作成されたときに true を返します。エラーが発生した場合は例外が生成されます。CreateKey で既存のキーを作成しようとしても処理は行われません。

CreateKey は不揮発性キーしか作成しません。Windows NT で揮発性キーを作成するには Windows API を直接呼び出さなくてはなりません。

CreateKey は KEY_ALL_ACCESS のセキュリティアクセスを持つキーを作成します。さらにアクセスを制限したキーを作成するには，Windows API を直接呼び出さなくてはなりません。

CreateKey で作成されたキーは値を持ちません。キーの値を設定するには，WriteCurrency，WriteBinaryData，WriteBool，WriteDate，WriteDateTime，WriteFloat，WriteInteger，WriteString，または WriteTime プロシージャを使用する必要があります。