System.Win.Registry.TRegistry.RegistryConnect

Übergeordnet: TRegistry

Delphi

function RegistryConnect(const UNCName: string): Boolean;

C++

bool __fastcall RegistryConnect(const System::UnicodeString UNCName);

Eigenschaften

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

Beschreibung

Richtet eine Verbindung zur Registrierdatenbank auf einem anderen Computer ein.

Mit RegistryConnect wird eine Verbindung zur Registrierung auf einem anderen Computer eingerichtet, der unter Windows 95 oder Windows NT läuft. Der String UNCName enthält den Namen des Remote-Computers und muss in folgender Form angegeben werden:

\\computername

Hierbei bezeichnet "computername" den Remote-Computer. Wenn UNCName nil (Delphi) oder NULL (C++) ist, wird der Name des lokalen Rechners verwendet.

Anmerkung: Vor dem Aufruf von RegistryConnect muss die Anwendung die Eigenschaft RootKey ihres Registrierungsobjekts auf HKEY_USERS oder HKEY_LOCAL_MACHINE setzen.

Wenn die Verbindung erfolgreich hergestellt werden konnte, setzt RegistryConnect die Eigenschaft RootKey auf den Hauptschlüssel des Remote-Computers und gibt true zurück. Im Fehlerfall wird false zurückgegeben, und RootKey bleibt unverändert.