System.Win.Registry.TRegistry.SaveKey
Delphi
function SaveKey(const Key, FileName: string): Boolean;
C++
bool __fastcall SaveKey(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
Öffnet den angegebenen Schlüssel in der Zugriffsebene KEY_ALL_ACCESS und speichert den angegebenen Schlüssel zusammen mit allen Unterschlüsseln und Datenwerten in einer Hive-Datei.
Mit SaveKey wird ein Schlüssel in der Zugriffsebene KEY_ALL_ACCESS geöffnet. Er gelangt dann mit allen Unterschlüsseln und Datenwerten in eine Hive-Datei. Der Begriff Hive bezeichnet eine aus einzelnen Teilen bestehende Menge von Schlüsseln, Unterschlüsseln und Datenwerten, deren Verzweigung von der obersten Ebene der Registrierungshierarchie ausgeht.
Der String Key enthält den Schlüssel, der gespeichert werden soll. Der Parameter FileName gibt die Datei an, in der die Informationen gespeichert werden sollen. Es muss sich um den Namen einer neuen, noch nicht vorhandenen Datei handeln. Bei Dateisystemen, denen eine Dateizuordnungstabelle (FAT) zugrunde liegt, darf FileName keine Namenserweiterung enthalten.
Von SaveKey erzeugte Dateien werden als Parameter an die Funktionen RestoreKey, ReplaceKey und LoadKey übergeben.
Bei erfolgreicher Ausführung gibt SaveKey den Wert true zurück und schließt den Schlüssel.