System.Win.Registry.TRegistry.CreateKey

Übergeordnet: TRegistry

Delphi

function CreateKey(const Key: string): Boolean;

C++

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

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.Win.Registry.pas System.Win.Registry.hpp	System.Win.Registry	TRegistry

Beschreibung

Erzeugt in der Registrierung einen neuen Schlüssel.

Mit CreateKey wird ein neuer Schlüssel in die Registrierung eingefügt. Key gibt den Namen des neuen Schlüssels an. Key kann ein absoluter oder ein relativer Schlüsselname sein. Ein absoluter Schlüssel beginnt mit einem Backslash und setzt direkt auf den Hauptschlüssel auf. Ein relativer Schlüssel ist ein Unterschlüssel des aktuellen.

CreateKey gibt true zurück, wenn die Erzeugung erfolgreich ist. Im Fehlerfall wird eine Exception ausgelöst. Der Versuch, einen bereits vorhandenen Schlüssel erneut zu erzeugen, hat keine Auswirkung.

CreateKey erzeugt nur permanente Schlüssel. Wenn unter Windows NT temporäre Schlüssel erforderlich sind, muss die Windows-API direkt aufgerufen werden.

Alle erzeugten Schlüssel haben die Zugriffsebene KEY_ALL_ACCESS. Wenn Sie Schlüssel mit eingeschränktem Zugriff wünschen, müssen Sie die Windows-API direkt aufrufen.

Ein von CreateKey erzeugter Schlüssel hat zunächst keine Werte. Zur Einstellung von Werten dienen die Prozeduren WriteCurrency, WriteBinaryData, WriteBool, WriteDate, WriteDateTime, WriteFloat, WriteInteger, WriteString und WriteTime.