System.Win.Registry.TRegistry.MoveKey

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure MoveKey(const OldName, NewName: string; Delete: Boolean);

C++

void __fastcall MoveKey(const System::UnicodeString OldName, const System::UnicodeString NewName, bool Delete);

Eigenschaften

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

Beschreibung

Verschiebt einen vorhandenen Schlüssel zusammen mit Unterschlüsseln und Datenwerten an eine neue Position. Dabei wird ein neuer Schlüsselname verwendet.

Mit MoveKey wird ein vorhandener Schlüssel zusammen mit Unterschlüsseln und Datenwerten an eine andere Position verschoben oder kopiert. Unter Windows 95 verläuft der Kopiervorgang rekursiv. Eventuell vorhandene Unterschlüssel und deren Datenwerte werden ebenfalls kopiert. Nach Beendigung des Vorgangs wird der neue Schlüssel geschlossen. Unter Windows NT müssen die Unterschlüssel explizit mit MoveKey verschoben werden.

Der Parameter OldName bezeichnet den Schlüssel, der kopiert oder verschoben werden soll. Der neue Name für die Kopie des Schlüssels wird in NewName übergeben. Wenn der Name in NewName noch nicht existiert, wird er von MoveKey erzeugt. Der boolesche Parameter Delete steuert, ob der alte Schlüssel nach dem Kopiervorgang gelöscht werden soll: true bedeutet, dass OldName nach dem Kopieren gelöscht wird. Andernfalls wird der alte Schlüssel geschlossen.

Siehe auch