Registry.TRegistry.RestoreKey
Contents |
Delphi-Informationen
von Registry.pas
function RestoreKey(const Key: string; const FileName: string): Boolean;
Unit: Registry
Typ: Methode
Sichtbarkeit: public
Member von: TRegistry
C++-Informationen
von Registry.hpp
bool __fastcall RestoreKey(System::UnicodeString Key, System::UnicodeString FileName);
Unit: Registry
Typ: Methode
Sichtbarkeit: public
Member von: 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.