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.RegistryKey
Public ReadOnly Property LocalMachine As RegistryKey
Property 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 |