System.Win.Registry.TRegistry.LoadKey

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function LoadKey(const Key, FileName: string): Boolean;

C++

bool __fastcall LoadKey(const System::UnicodeString Key, const System::UnicodeString FileName);

Eigenschaften

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

Beschreibung

Erzeugt ausgehend vom Hauptschlüssel einen Unterschlüssel und lädt in diesen Registrierungsinformationen aus einer Datei.

Rufen Sie LoadKey auf, um folgendes zu erreichen:

Ausgehend vom Hauptschlüssel einen neuen Unterschlüssel erzeugen.

Registrierungsinformationen aus einer Datei in den Unterschlüssel laden. Registrierungsinformationen können Datenwerte, Unterschlüssel sowie Datenwerte für diese Unterschlüssel umfassen.

Mit LoadKey wird es vereinfacht, in einer einzigen Operation einen Schlüssel mit Datenwerten sowie Unterschlüssel mit Datenwerten zu erzeugen. Für die Gesamtheit dieser Schlüssel und Datenwerte hat sich in der Literatur der englische Begriff "Hive" eingebürgert. Eine wörtliche Übersetzung wäre "Bienenschwarm". Dieser Hive wird am besten aus einer Datei eingelesen, anstatt jeden Schlüssel und jeden Wert einzeln zu erzeugen. Ein solches Verfahren ist vor allem dann sinnvoll, wenn die Anwendung vom Benutzer zur Laufzeit neu konfiguriert werden kann.

Anmerkung:  Vor dem Aufruf von LoadKey muss die Anwendung die Eigenschaft RootKey auf HKEY_USERS, HKEY_LOCAL_MACHINE oder auf den Wert gesetzt werden, der mit einem vorherigen Aufruf von RegistryConnect ermittelt wurde.

Der Parameter Key ist der Name des Unterschlüssels, der erzeugt werden soll. Der Parameter FileName bezeichnet den Speicherort der Datei mit den Registrierungsinformationen. Diese Datei muss vorher mit der Funktion SaveKey oder der Windows-API-Funktion RegSaveKey erzeugt worden sein. Bei Systemen, denen eine Dateizuordnungstabelle (FAT) zugrunde liegt, darf FileName keine Erweiterung enthalten.

Siehe auch