RegistryProxy.LocalMachine Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns a RegistryKey type, which provides access to HKEY_LOCAL_MACHINE.
public:
property Microsoft::Win32::RegistryKey ^ LocalMachine { Microsoft::Win32::RegistryKey ^ get(); };public Microsoft.Win32.RegistryKey LocalMachine { get; }member this.LocalMachine : Microsoft.Win32.RegistryKeyPublic ReadOnly Property LocalMachine As RegistryKeyProperty Value
Examples
This example opens the subkey Software\MyCompany\Preferences and sets the value FontColor to "red".
My.Computer.Registry.LocalMachine.OpenSubKey(
"Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")
Remarks
HKEY_LOCAL_MACHINE is usually used to store settings that do not vary from user to user in Windows. All users of the computer share this key. Its five subkeys (Hardware, SAM, Security, Software, and System) hold configuration data for the local machine.
The RegistryPermission class, which is in the System.Security.Permissions namespace, controls access to registry variables. Registry variables should not be stored in memory locations where code without RegistryPermission can access them. Similarly, when granting permissions, grant the fewest privileges necessary to get the job done.
Registry permission access values are defined by the RegistryPermissionAccess enumeration. The following table details its members.
| Value | Description |
|---|---|
| AllAccess | Create, read, and write access to registry variables. |
| Create | Create access to registry variables. |
| NoAccess | No access to registry variables. |
| Read | Read access to registry variables. |
| Write | Write access to registry variables. |
The following table lists examples of tasks involving the My.Computer.Registry object.
| To | See |
|---|---|
| Create a registry key and set its value | How to: Create a Registry Key and Set Its Value |
| Delete a registry key | How to: Delete a Registry Key |
| Read a value from a registry key | How to: Read a Value from a Registry Key |
