System.Win.Registry.TRegistry.ReplaceKey
Delphi
function ReplaceKey(const Key, FileName, BackUpFileName: string): Boolean;
C++
bool __fastcall ReplaceKey(const System::UnicodeString Key, const System::UnicodeString FileName, const System::UnicodeString BackUpFileName);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.Win.Registry.pas System.Win.Registry.hpp |
System.Win.Registry | TRegistry |
Beschreibung
Ersetzt die Hive-Datei, in der ein Schlüssel mit seinen Unterschlüsseln gespeichert ist, durch eine andere Datei. Beim nächsten Start des Systems besitzt dann der Schlüssel und seine Unterschlüssel die Werte, die aus der neuen Datei stammen.
Mit ReplaceKey wird die Datei ausgetauscht, in der ein Schlüssel und seine Unterschlüssel gespeichert sind. 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 FileName enthält den Namen der Datei mit den neuen Informationen. BackUpFileName ist der Name der Sicherungsdatei, die bisher die Informationen enthielt.
Bei erfolgreicher Ausführung gibt ReplaceKey den Wert true zurück.
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.