UDF > WinAPIEx > Registry >


_WinAPI_RegConnectRegistry

Etablit une connexion avec une clé de registre prédéfini sur un autre ordinateur

#include <WinAPIReg.au3>
_WinAPI_RegConnectRegistry ( $sComputer, $hKey )

Paramètres

$sComputer Le nom de l'ordinateur distant. La chaîne a la forme de "\\computername". L'appelant doit avoir accès à l'ordinateur distant ou la fonction échoue. Si ce paramètre est 0, le nom de l'ordinateur local est utilisé.
$hKey La handle de registre prédéfini. Ce paramètre peut être l'une des clés prédéfinis suivantes sur l'ordinateur distant:
$HKEY_LOCAL_MACHINE
$HKEY_PERFORMANCE_DATA
$HKEY_USERS

Valeur de retour

Succès: Retourne le handle de la clé de l'ordinateur distant.
Échec: Retourne 0 et définit @error <> 0, @extended peut contenir le code d'erreur du système.

Remarques

Cette fonction nécessite que le service Remote Registry soit en cours d'exécution sur l'ordinateur distant.

Si l'utilisateur actuel n'a pas un accès adéquat à l'ordinateur distant, l'appel à _WinAPI_RegConnectRegistry() échoue. Si l'ordinateur est joint à un groupe de travail et si la stratégie "Force network logons using local accounts to authenticate as Guest" est activée, la fonction échoue. Notez que cette stratégie est activée par défaut si l'ordinateur est joint à un groupe de travail.

Lorsque la handle retourné par _WinAPI_RegConnectRegistry() n'est plus nécessaire, il doit être fermé en appelant _WinAPI_RegCloseKey().

En relation

_WinAPI_RegCloseKey

Voir aussi

Consultez RegConnectRegistry dans la librairie MSDN.