System.Win.Registry.TRegistry.RestoreKey
Delphi
function RestoreKey(const Key, FileName: string): Boolean;
C++
bool __fastcall RestoreKey(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 erneut und überschreibt alle Informationen des Schlüssels und seiner Unterschlüssel mit Registrierungsdaten, die in einer Hive-Datei gespeichert sind.
Mit RestoreKey wird der angegebene Schlüssel in der Zugriffsebene KEY_ALL_ACCESS geöffnet, und alle Informationen im Schlüssel und seinen Unterschlüsseln werden durch die Registrierungsdaten aus einer Hive-Datei ersetzt. 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 Parameter Key enthält den Schlüssel, der geöffnet werden soll. FileName ist der Name der Datei mit den Hive-Informationen.
Bei erfolgreicher Ausführung gibt RestoreKey den Wert true zurück, und der Schlüssel wird geschlossen.
Anmerkung: Die in FileName übergebene Datei muss mit der Funktion SaveKey oder mit einem direkten Aufruf der Windows 95/NT-API-Funktion RegSaveKey angelegt worden sein. Bei Dateisystemen, denen eine Dateizuordnungstabelle (FAT) zugrunde liegt, darf FileName keine Namenserweiterung enthalten.