System.Win.Registry.TRegistry.RegistryConnect

Aller au parent : TRegistry

Delphi

function RegistryConnect(const UNCName: string): Boolean;

C++

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

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.Win.Registry.pas System.Win.Registry.hpp	System.Win.Registry	TRegistry

Description

Etablit une connexion avec un registre sur un autre ordinateur.

RegistryConnect permet d'établir une connexion avec un registre sur un autre ordinateur fonctionnant sous Windows 95 ou Windows NT. UNCName désigne le nom de l'ordinateur distant et doit être de la forme :

\\nommachine

où computername est le nom de l'ordinateur distant. Si UNCName vaut nil (Delphi) ou NULL (C++), le nom utilisé est celui de l'ordinateur local.

Remarque : Avant d'appeler RegistryConnect, une application doit initialiser la propriété RootKey de son objet registre à HKEY_USERS ou HKEY_LOCAL_MACHINE.

Si la connexion est établie, RegistryConnect initialise la propriété RootKey à la clé racine de l'ordinateur distant et renvoie true. Si elle ne peut pas être établie, RegistryConnect renvoie false, et RootKey demeure inchangée.