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 プロシージャを使用する必要があります。