||This article's lead section may not adequately summarize key points of its contents. (March 2012)|
Windows Registry is a hierarchical database that stores configuration settings and options on Microsoft Windows operating systems. It contains settings for low-level operating system components and for applications running on the platform that have opted to use the Registry. The kernel, device drivers, services, SAM, user interface and third-party applications can all make use of the Registry. The Registry also provides a means to access counters for profiling system performance.
When first introduced with Windows 3.1, Windows Registry's primary purpose was to store configuration information for COM-based components. With the introduction of Windows 95 and Windows NT, its use was extended to tidy up the profusion of per-program INI files that had previously been used to store configuration settings for Windows programs. It is not a requirement for a Windows application to use Windows Registry—for example, .NET Framework applications use XML files for configuration, while portable applications usually keep their configuration data within files in the folder where the application executable resides.
Prior to the Registry, .INI files stored each program's settings into a text file, often located in a shared location that did not allow for user-specific settings in a multi-user scenario. By contrast, Windows Registry stores all application settings in one logical repository (but a number of discrete files) and in a standardized form. According to Microsoft this offers several advantages over .INI files. Since file parsing is done much more efficiently with a binary format, it may be read from or written to more quickly than an INI file. As well, strongly typed data can be stored in the Registry, as opposed to the text information stored in .INI files. This is a benefit when editing keys manually using regedit.exe, the built-in Windows Registry editor. Because user-based Registry settings are loaded from a user-specific path rather than from a read-only system location, the Registry allows multiple users to share the same machine, and also allows programs to work for less privileged users. Backup and restoration is also simplified as the Registry can be accessed over a network connection for remote management/support, including from scripts, using the standard set of APIs, as long as the Remote Registry service is running and firewall rules permit this.
As the Registry is constructed as a database, it offers improved system integrity with features such as atomic updates. If two processes attempt to update the same Registry value at the same time, one process's change will precede the others and the overall consistency of the data will be maintained. Where changes are made to .INI files, such race conditions can result in inconsistent data which doesn't match either attempted update. Windows Vista and later operating systems provide transactional updates to the Registry by means of the Kernel Transaction Manager, extending the atomicity guarantees across multiple key and/or value changes, with traditional commit-abort semantics. (Note however that NTFS provides such support for the file system as well, so the same guarantees could, in theory, be obtained with traditional configuration files.)
The Registry contains two basic elements: keys and values. Registry keys are container objects similar to folders. Registry values are non-container objects similar to files. Keys may contain values or further keys. Keys are referenced with a syntax similar to Windows' path names, using backslashes to indicate levels of hierarchy. Keys must have a case insensitive name without backslashes.
The hierarchy of Registry keys can only be accessed from a known root key handle (which is anonymous but whose effective value is a constant numeric handle) that is mapped to the content of a Registry key preloaded by the kernel from a stored "hive", or to the content of a subkey within another root key, or mapped to a registered service or DLL that provides access to its contained subkeys and values.
E.g. HKEY_LOCAL_MACHINE\Software\Microsoft\Windows refers to the subkey "Windows" of the subkey "Microsoft" of the subkey "Software" of the HKEY_LOCAL_MACHINE root key.
There are seven predefined root keys, traditionally named according to their constant handles defined in the Win32 API, or by synonymous abbreviations (depending on applications):
Like other files and services in Windows, all Registry keys may be restricted by access control lists (ACLs), depending on user privileges, or on security tokens acquired by applications, or on system security policies enforced by the system (these restrictions may be predefined by the system itself, and configured by local system administrators or by domain administrators). Different users, programs, services or remote systems may only see some parts of the hierarchy or distinct hierarchies from the same root keys.
Registry values are name/data pairs stored within keys. Registry values are referenced separately from Registry keys. Each Registry value stored in a Registry key has a unique name whose letter case is not significant. The Windows API functions that query and manipulate Registry values take value names separately from the key path and/or handle that identifies the parent key. Registry values may contain backslashes in their names, but doing so makes them difficult to distinguish from their key paths when using some legacy Windows Registry API functions (whose usage is deprecated in Win32).
The terminology is somewhat misleading, as each Registry key is similar to an associative array, where standard terminology would refer to the name part of each Registry value as a "key". The terms are a holdout from the 16-bit Registry in Windows 3, in which Registry keys could not contain arbitrary name/data pairs, but rather contained only one unnamed value (which had to be a string). In this sense, the entire Registry was like a single associative array where the Registry keys (in both the Registry sense and dictionary sense) formed a hierarchy, and the Registry values were all strings. When the 32-bit Registry was created, so was the additional capability of creating multiple named values per key, and the meanings of the names were somewhat distorted. For compatibility with the previous behavior, each Registry key may have a "default" value, whose name is the empty string.
Each value can store arbitrary data with variable length and encoding, but which is associated with a symbolic type (defined as a numeric constant) defining how to parse this data. The standard types are:
|Type ID||Symbolic type name||Meaning and encoding of the data stored in the Registry value|
|0||REG_NONE||No type (the stored value, if any)|
|1||REG_SZ||A string value, normally stored and exposed in UTF-16LE (when using the Unicode version of Win32 API functions), usually terminated by a NUL character|
|2||REG_EXPAND_SZ||An "expandable" string value that can contain environment variables, normally stored and exposed in UTF-16LE, usually terminated by a NUL character|
|3||REG_BINARY||Binary data (any arbitrary data)|
|4||REG_DWORD / REG_DWORD_LITTLE_ENDIAN||A DWORD value, a 32-bit unsigned integer (numbers between 0 and 4,294,967,295 [232 – 1]) (little-endian)|
|5||REG_DWORD_BIG_ENDIAN||A DWORD value, a 32-bit unsigned integer (numbers between 0 and 4,294,967,295 [232 – 1]) (big-endian)|
|6||REG_LINK||A symbolic link (UNICODE) to another Registry key, specifying a root key and the path to the target key|
|7||REG_MULTI_SZ||A multi-string value, which is an ordered list of non-empty strings, normally stored and exposed in UTF-16LE, each one terminated by a NUL character, the list being normally terminated by a second NUL character.|
|8||REG_RESOURCE_LIST||A resource list (used by the Plug-n-Play hardware enumeration and configuration)|
|9||REG_FULL_RESOURCE_DESCRIPTOR||A resource descriptor (used by the Plug-n-Play hardware enumeration and configuration)|
|10||REG_RESOURCE_REQUIREMENTS_LIST||A resource requirements list (used by the Plug-n-Play hardware enumeration and configuration)|
|11||REG_QWORD / REG_QWORD_LITTLE_ENDIAN||A QWORD value, a 64-bit integer (either big- or little-endian, or unspecified) (introduced in Windows XP)|
The keys at the root level of the hierarchical database are generally named by their Windows API definitions, which all begin "HKEY". They are frequently abbreviated to a three- or four-letter short name starting with "HK" (e.g. HKCU and HKLM). Technically, they are predefined handles (with known constant values) to specific keys that are either maintained in memory, or stored in hive files stored in the local filesystem and loaded by the system kernel at boot time and then shared (with various access rights) between all processes running on the local system, or loaded and mapped in all processes started in a user session when the user logs on the system.
The HKEY_LOCAL_MACHINE (local machine-specific configuration data) and HKEY_CURRENT_USER (user-specific configuration data) nodes have a similar structure to each other; user applications typically look up their settings by first checking for them in "HKEY_CURRENT_USER\Software\Vendor's name\Application's name\Version\Setting name", and if the setting is not found, look instead in the same location under the HKEY_LOCAL_MACHINE key. However, the converse may apply for administrator-enforced policy settings where HKLM may take precedence over HKCU. The Windows Logo Program has specific requirements for where different types of user data may be stored, and that the concept of least privilege be followed so that administrator-level access is not required to use an application.[a]
Even though the Registry presents itself as an integrated hierarchical database, branches of the Registry are actually stored in a number of disk files called hives. (The word hive constitutes an in-joke.)
Some hives are volatile and are not stored on disk at all. An example of this is the hive of branch starting at HKLM\HARDWARE. This hive records information about system hardware and is created each time the system boots and performs hardware detection.
Individual settings for users on a system is stored in a hive (disk file) per user. During user login the system loads the user hive under the HKEY_USERS key, but it also sets the HKCU (HKEY_CURRENT_USER) symbolic reference to point to the current user. This allows applications to store/retrieve settings for the current user implicitly under the HKCU key.
Not all hives are loaded at any one time. At boot time only a minimal set of hives are loaded and after that hives are loaded as the operating system initializes and as users log in or whenever a hive is explicitly loaded by an application.
The Registry contains important configuration information for the operating system, for installed applications as well as individual settings for each user and application. A careless change to the operating system configuration in the Registry could cause irreversible damage, so it is usually only installer programs which perform changes to the Registry database during installation/configuration and removal. If a user wants to edit the Registry manually, Microsoft recommends that a backup of the Registry is performed before the change. Editing the Registry is sometimes necessary when working around Windows-specific issues e.g. problems when logging onto a domain can be resolved by editing the Registry.
Windows Registry can be edited manually using programs such as regedit.exe, although these tools do not expose some of Registry's metadata such as the last modified date.
Registry Editor allows users to perform the following functions:
.REG files (also known as Registration entries) are text-based human-readable files for exporting and importing portions of the Registry. On Windows 2000 and later, they contain the string Windows Registry Editor Version 5.00 at the beginning and are Unicode-based. On Windows 9x and NT 4.0 systems, they contain the string REGEDIT4 and are ANSI-based.[not in citation given] Windows 9x format .REG files are compatible with Windows 2000 and later. The Registry Editor on Windows on these systems also supports exporting .REG files in Windows 9x/NT format. Data is stored in .REG files in the following syntax:
[<Hive name>\<Key name>\<Subkey name>] "Value name"=<Value type>:<Value data>
The Default Value of a key can be edited by using @ instead of "Value Name":
[<Hive name>\<Key name>\<Subkey name>] @=<Value type>:<Value data>
String values do not require a <Value type> (see example), but backslashes ('\') need to be written as a double-backslash ('\\'), and quotes ('"') as backslash-quote ('\"').
For example, to add the values "Value A", "Value B", "Value C", "Value D", "Value E", "Value F", "Value G", "Value H", "Value I", "Value J", "Value K", "Value L", and "Value M" to the HKLM\SOFTWARE\Foobar key,
Data from .REG files can be added/merged with the Registry by double-clicking these files or using the /s switch in the command line. .REG files can also be used to remove Registry data.
To remove a key (and all subkeys, values and data), the key name must be preceded by a minus sign ("-").
For example, to remove the HKLM\SOFTWARE\Foobar key (and all subkeys, values and data),
To remove a value (and its data), the values to be removed must have a minus sign ("-") after the equal sign ("=").
For example, to remove only the "Value A" and "Value B" values (and their data) from the HKLM\SOFTWARE\Foobar key,
[HKEY_LOCAL_MACHINE\SOFTWARE\Foobar] "Value A"=- "Value B"=-
To remove only the (Default) value of the key HKLM\SOFTWARE\Foobar (and its data),
Lines beginning with a semicolon are considered as comments:
; This is a comment. This can be placed in any part of a .reg file [HKEY_LOCAL_MACHINE\SOFTWARE\Foobar] "Value"="Example string"
Windows group policies can change Registry keys for a number of machines or individual users based on policies. When a policy first takes effect for a machine or for an individual user of a machine, the Registry settings specified as part of the policy is applied to the machine or user settings.
Windows will also look for updated policies and apply them periodically, typically every 90 minutes.
Through its scope a policy defines which machines and/or users the policy is to be applied to. Whether a machine or user is within the scope of a policy or not is defined by a set of rules which can filter on the location of the machine/user account in organizational directory, specific user/machine accounts or security groups. More advanced rules can be set up using Windows Management Instrumentation expressions. Such rules can filter on properties such as computer vendor name, CPU architecture, installed software, networks connected to etc.
For instance, the administrator can create a policy with one set of Registry settings for machines in the accounting department and policy with another (lock-down) set of Registry settings for kiosk terminals in the visitors area. When a machine is moved from one scope to another (e.g. changing its name or moving it to another organizational unit), the correct policy is automatically applied. When a policy is changed it is automatically re-applied to all machines currently in its scope.
The policy is edited through a number of administrative templates which provides a user interface for picking and changing settings. The set of administrative templates is extensible and software packages which support such remote administration can register their own templates.
The Registry can be manipulated in a number of ways from the command line. The
RegIni.exe utility tools are included in Windows XP and later versions of Windows. Alternative locations for legacy versions of Windows include the Resource Kit CDs or the original Installation CD of Windows.
.REG file can be imported from the command line with the following command:
RegEdit.exe /s file
The /s means the file will be silent merged to the Registry. If the
/s parameter is omitted the user will be asked to confirm the operation. In Windows 98, Windows 95 and at least some configurations of Windows XP the
/s switch also causes
RegEdit.exe to ignore the setting in the Registry that allows administrators to disable it. When using the
RegEdit.exe does not return an appropriate return code if the operation fails, unlike
Reg.exe which does.
RegEdit.exe /e file
exports the whole Registry in V5 format to a UNICODE
.REG file, while any of
RegEdit.exe /e file HKEY_CLASSES_ROOT[\<key>] RegEdit.exe /e file HKEY_CURRENT_CONFIG[\<key>] RegEdit.exe /e file HKEY_CURRENT_USER[\<key>] RegEdit.exe /e file HKEY_LOCAL_MACHINE[\<key>] RegEdit.exe /e file HKEY_USERS[\<key>]
export the specified (sub)key (which has to be enclosed in quotes if it contains spaces) only.
RegEdit.exe /a file
exports the whole Registry in V4 format to an ANSI
RegEdit.exe /a file <key>
exports the specified (sub)key (which has to be enclosed in quotes if it contains spaces) only.
We can use also
Reg.exe. Here is a sample to display the value of the Registry value Version:
Reg.exe QUERY HKLM\Software\Microsoft\ResKit /v Version
Registry permissions can be manipulated through the command line using
RegIni.exe and the
SubInACL.exe tool. For example, the permissions on the HKEY_LOCAL_MACHINE\SOFTWARE key can be displayed using:
SubInACL.exe /keyreg HKEY_LOCAL_MACHINE\SOFTWARE /display
Windows PowerShell comes with a Registry provider which presents the Registry as a location type similar to the file system. The same commands used to manipulate files/directories in the file system can be used to manipulate keys/values of the Registry.
Also like the file system, PowerShell uses the concept of a current location which defines the context on which commands by default operate. The Get-ChildItem (also available through the alias ls or dir) retrieves the child keys of the current location. By using the Set-Location (or the alias cd) command the user can change the current location to another key of the Registry. Commands which rename items, remove items, create new items or set content of items or properties can be used to rename keys, remove keys or entire sub-trees or change values.
Through PowerShell scripts files a user/administrator can prepare scripts which, when executed, make changes to the Registry. Such scripts can be distributed to users/administrators who can execute them on individual machines.
The PowerShell Registry provider supports transactions, i.e. multiple changes to the Registry can be bundled into a single atomic transaction. An atomic transaction ensures that either all of the changes are committed to the database, or if the script fails, none of the changes is committed to the database.
The Registry can be edited through the APIs of the Advanced Windows 32 Base API Library (advapi32.dll).
|List of Registry API functions|
Many programming languages offer built-in runtime library functions or classes that wrap the underlying Windows APIs and thereby enable programs to store settings in the Registry (e.g.
Microsoft.Win32.Registry in VB.NET and C#, or
TRegistry in Delphi and Free Pascal). COM-enabled applications like Visual Basic 6 can use the WSH
WScript.Shell object. Another way is to use the Windows Resource Kit Tool,
Reg.exe by executing it from code, although this is considered poor programming practice.
Similarly, scripting languages such as Perl (with
Win32::TieRegistry), Python (with winreg), TCL (which comes bundled with the Registry package), Windows Powershell and Windows Scripting Host also enable Registry editing from scripts.
Prior to the introduction of registration-free COM, developers were encouraged to add initialization code to in-process and out-of-process binaries to perform the Registry configuration required for that object to work. For in-process binaries such as .DLL and .OCX files, the modules typically exported a function called DllInstall() that could be called by installation programs or invoked manually with utilities like Regsvr32.exe; out-of-process binaries typically support the commandline arguments /Regserver and /Unregserver that created or deleted the required Registry settings. COM applications that break because of DLL Hell issues can commonly be repaired with RegSvr32.exe or the /RegServer switch without having to re-invoke installation programs.
Windows exposes APIs that allows user-mode applications to register to receive a notification event if a particular Registry key is changed. APIs are also available to allow kernel-mode applications to filter and modify Registry calls made by other applications.
Windows also supports remote access to the Registry of another computer via the
RegConnectRegistry function if the Remote Registry service is running, correctly configured and its network traffic is not firewalled.
The Registry is physically stored in several files, which are generally obfuscated from the user-mode APIs used to manipulate the data inside the Registry. Depending upon the version of Windows, there will be different files and different locations for these files, but they are all on the local machine. The location for system Registry files in Windows NT is %SystemRoot%\System32\Config; the user-specific HKEY_CURRENT_USER user Registry hive is stored in Ntuser.dat inside the user profile. There is one of these per user; if a user has a roaming profile, then this file will be copied to and from a server at logout and login respectively. A second user-specific Registry file named UsrClass.dat contains COM Registry entries and does not roam by default.
Windows NT systems store the Registry in a binary file format which can be exported, loaded and unloaded by the Registry Editor in these operating systems. The following system Registry files are stored in %SystemRoot%\System32\Config\:
The following file is stored in each user's profile folder:
For Windows 2000, Server 2003 and Windows XP, the following additional user-specific file is used for file associations and COM information:
For Windows Vista and later, the path was changed to:
Windows 2000 kept an alternate copy of the Registry hives (.ALT) and attempts to switch to it when corruption is detected. Windows XP and Windows Server 2003 do not maintain a System.alt hive because NTLDR on those versions of Windows can process the System.log file to bring up to date a System hive that has become inconsistent during a shutdown or crash. In addition, the %SystemRoot%\Repair folder contains a copy of the system's Registry hives that were created after installation and the first successful startup of Windows.
Each Registry data file has an associated file with a ".log" extension that acts as a transaction log that is used to ensure that any interrupted updates can be completed upon next startup. Internally, Registry files are split into 4 kB "bins" that contain collections of "cells".
The Registry files are stored in the %WINDIR% directory under the names USER.DAT and SYSTEM.DAT with the addition of CLASSES.DAT in Windows Me. Also, each user profile (if profiles are enabled) has its own USER.DAT file which is located in the user's profile directory in %WINDIR%\Profiles\<User name>\.
The only Registry file is called REG.DAT and it is stored in the %WINDIR% directory.
Each key in the Registry of Windows NT versions can have an associated security descriptor. The security descriptor contains an access control list (ACL) that describes which user groups or individual users are granted or denied access permissions. The set of Registry permissions include 10 rights/permissions which can be explicitly allowed or denied to a user or a group of users.
|Query Value||The right to read the Registry key value.|
|Set Value||The right to write a new value|
|Create Subkey||The right to create subkeys.|
|Enumerate Subkeys||Allow the enumeration of subkeys.|
|Notify||The right to request change notifications for Registry keys or subkeys.|
|Create Link||Reserved by the operating system.|
|Delete||The right to delete a key.|
|Write DACL||The right to modify permissions of the container’s DACL.|
|Write Owner||The right to modify the container’s owner.|
|Read Control||The right to read the DACL.|
As with other securable objects in the operating system, individual access control entries (ACE) on the security descriptor can be explicit or inherited from a parent object.
Windows Resource Protection is a feature of Windows Vista and later versions of Windows that uses security to deny Administrators and the system WRITE access to some sensitive keys to protect the integrity of the system from malware and accidental modification.
Special ACEs on the security descriptor can also implement mandatory integrity control for the Registry key and subkeys. A process running at a lower integrity level cannot write, change or delete a Registry key/value, even if the account of the process has otherwise been granted access through the ACL. For instance, Internet Explorer running in Protected Mode can read medium and low integrity Registry keys/values of the currently logged on user, but it can only modify low integrity keys.
Outside security, Registry keys cannot be deleted or edited due to other causes. Registry keys containing NUL characters cannot be deleted with standard registry editors and require a special utility for deletion, such as RegDelNull.
Different editions of Windows have supported a number of different methods to back up and restore the Registry over the years, some of which are now deprecated:
RDISK.EXE, a utility to back up and restore the entire Registry.
Windows 2000 and later versions of Windows use Group Policy to enforce Registry settings through a Registry-specific client extension in the Group Policy processing engine. Policy may be applied locally to a single computer using gpedit.msc, or to multiple users and/or computers in a domain using gpmc.msc.
With Windows 95, Windows 98, Windows ME and Windows NT 4.0, administrators can use a special file to be merged into the Registry, called a policy file (POLICY.POL). The policy file allows administrators to prevent non-administrator users from changing Registry settings like, for instance, the security level of Internet Explorer and the desktop background wallpaper. The policy file is primarily used in a business with a large number of computers where the business needs to be protected from rogue or careless users.
The default extension for the policy file is .POL. The policy file filters the settings it enforces by user and by group (a "group" is a defined set of users). To do that the policy file merges into the Registry, preventing users from circumventing it by simply changing back the settings. The policy file is usually distributed through a LAN, but can be placed on the local computer.
The policy file is created by a free tool by Microsoft that goes by the filename poledit.exe for Windows 95/Windows 98 and with a computer management module for Windows NT. The editor requires administrative permissions to be run on systems that uses permissions. The editor can also directly change the current Registry settings of the local computer and if the remote Registry service is installed and started on another computer it can also change the Registry on that computer. The policy editor loads the settings it can change from .ADM files, of which one is included, that contains the settings the Windows shell provides. The .ADM file is plain text and supports easy localisation by allowing all the strings to be stored in one place.
Windows NT kernels support redirection of INI file-related APIs into a virtual file in a Registry location such as HKEY_CURRENT_USER using a feature called "InifileMapping". This functionality was introduced to allow legacy applications written for 16-bit versions of Windows to be able to run under Windows NT platforms on which the System folder is no longer considered an appropriate location for user-specific data or configuration. Non-compliant 32-bit applications can also be redirected in this manner, even though the feature was originally intended for 16-bit applications.
Windows Vista introduced limited Registry virtualization, whereby poorly written applications that do not respect the principle of least privilege and instead try to write user data to a read-only system location (such as the HKEY_LOCAL_MACHINE hive), are silently redirected to a more appropriate location, without changing the application itself.
Similarly, application virtualization redirects all of an application's invalid Registry operations to a location such as a file. Used together with file virtualization, this allows applications to run on a machine without being installed on it.
Low integrity processes may also use Registry virtualization. For example, Internet Explorer 7 or 8 running in "Protected Mode" on Windows Vista and above will automatically redirect Registry writes by ActiveX controls to a sandboxed location in order to frustrate some classes of security exploits.
The Application Compatibility Toolkit provides shims that can transparently redirect HKEY_LOCAL_MACHINE or HKEY_CLASSES_ROOT Registry operations to HKEY_CURRENT_USER to address "LUA" bugs that cause applications not to work for users with insufficient rights.
Critics labeled the Registry in Windows 95 a single point of failure, because re-installation of the operating system was required if the Registry became corrupt. However, Windows NT uses transaction logs to protect against corruption during updates. Current versions of Windows use two levels of log files to ensure integrity even in the case of power failure or similar catastrophic events during database updates. Even in the case of a non-recoverable error, Windows can repair or re-initialize damaged Registry entries during system boot.
|This section needs additional citations for verification. (November 2010)|
In Windows, use of the Registry for storing program data is a matter of developer's discretion. Microsoft provides programming interfaces for storing data in XML files (via MSXML) or database files (via SQL Server Compact) which developers can use instead. Developers are also free to use non-Microsoft alternative or develop their own proprietary data stores.
In contrast to Windows Registry's binary-based database model, some other operating systems use separate plain-text files for daemon and application configuration, but group these configurations together for ease of management.
|Wikibooks has a book on the topic of: Windows registry hacks|