RegistryKey::OpenRemoteBaseKey Method (RegistryHive, String^, RegistryView)
Opens a new registry key that represents the requested key on a remote machine with the specified view.
Assembly: mscorlib (in mscorlib.dll)
public: [ComVisibleAttribute(false)] static RegistryKey^ OpenRemoteBaseKey( RegistryHive hKey, String^ machineName, RegistryView view )
Parameters
- hKey
-
Type:
Microsoft.Win32::RegistryHive
The HKEY to open from the RegistryHive enumeration..
- machineName
-
Type:
System::String^
The remote machine.
- view
-
Type:
Microsoft.Win32::RegistryView
The registry view to use.
| Exception | Condition |
|---|---|
| ArgumentException | hKey or view is invalid. |
| IOException | machineName is not found. |
| ArgumentNullException | machineName is null. |
| ArgumentNullException | machineName is null. |
| UnauthorizedAccessException | The user does not have the necessary registry rights. |
| SecurityException | The user does not have the required permissions to perform this operation. |
The local machine registry is opened if machineName is String::Empty. The requested key must be a root key on the remote machine, and is identified by the appropriate RegistryHive value.
In order for a key to be opened remotely, both the server and client machines must be running the remote registry service, and have remote administration enabled.
On the 64-bit versions of Windows, portions of the registry are stored separately for 32-bit and 64-bit applications. There is a 32-bit view for 32-bit applications and a 64-bit view for 64-bit applications. If view is Registry64 but the remote machine is running a 32-bit operating system, the returned key will use the Registry32 view.
Available since 4.0