winreg.h header
This header is used by multiple technologies. For more information, see:
winreg.h contains the following programming interfaces:
Functions
| AbortSystemShutdownA Stops a system shutdown that has been initiated. (ANSI) |
| AbortSystemShutdownW Stops a system shutdown that has been initiated. (Unicode) |
| InitiateShutdownA Initiates a shutdown and restart of the specified computer, and restarts any applications that have been registered for restart. (ANSI) |
| InitiateShutdownW Initiates a shutdown and restart of the specified computer, and restarts any applications that have been registered for restart. (Unicode) |
| InitiateSystemShutdownA Initiates a shutdown and optional restart of the specified computer. (ANSI) |
| InitiateSystemShutdownExA Initiates a shutdown and optional restart of the specified computer, and optionally records the reason for the shutdown. (ANSI) |
| InitiateSystemShutdownExW Initiates a shutdown and optional restart of the specified computer, and optionally records the reason for the shutdown. (Unicode) |
| InitiateSystemShutdownW Initiates a shutdown and optional restart of the specified computer. (Unicode) |
| RegCloseKey Closes a handle to the specified registry key. |
| RegConnectRegistryA Establishes a connection to a predefined registry key on another computer. (ANSI) |
| RegConnectRegistryW Establishes a connection to a predefined registry key on another computer. (Unicode) |
| RegCopyTreeA Copies the specified registry key, along with its values and subkeys, to the specified destination key. (ANSI) |
| RegCopyTreeW Copies the specified registry key, along with its values and subkeys, to the specified destination key. (Unicode) |
| RegCreateKeyA Creates the specified registry key. If the key already exists in the registry, the function opens it. (ANSI) |
| RegCreateKeyExA Creates the specified registry key. If the key already exists, the function opens it. Note that key names are not case sensitive. (ANSI) |
| RegCreateKeyExW Creates the specified registry key. If the key already exists, the function opens it. Note that key names are not case sensitive. (Unicode) |
| RegCreateKeyTransactedA Creates the specified registry key and associates it with a transaction. (ANSI) |
| RegCreateKeyTransactedW Creates the specified registry key and associates it with a transaction. (Unicode) |
| RegCreateKeyW Creates the specified registry key. If the key already exists in the registry, the function opens it. (Unicode) |
| RegDeleteKeyA Deletes a subkey and its values. (ANSI) |
| RegDeleteKeyExA Deletes a subkey and its values from the specified platform-specific view of the registry. (ANSI) |
| RegDeleteKeyExW Deletes a subkey and its values from the specified platform-specific view of the registry. (Unicode) |
| RegDeleteKeyTransactedA Deletes a subkey and its values from the specified platform-specific view of the registry as a transacted operation. (ANSI) |
| RegDeleteKeyTransactedW Deletes a subkey and its values from the specified platform-specific view of the registry as a transacted operation. (Unicode) |
| RegDeleteKeyValueA Removes the specified value from the specified registry key and subkey. (ANSI) |
| RegDeleteKeyValueW Removes the specified value from the specified registry key and subkey. (Unicode) |
| RegDeleteKeyW Deletes a subkey and its values. (Unicode) |
| RegDeleteTreeA Deletes the subkeys and values of the specified key recursively. (ANSI) |
| RegDeleteTreeW Deletes the subkeys and values of the specified key recursively. (Unicode) |
| RegDeleteValueA Removes a named value from the specified registry key. (ANSI) |
| RegDeleteValueW Removes a named value from the specified registry key. (Unicode) |
| RegDisablePredefinedCache Disables handle caching of the predefined registry handle for HKEY_CURRENT_USER for the current process. |
| RegDisablePredefinedCacheEx Disables handle caching for all predefined registry handles for the current process. |
| RegDisableReflectionKey Disables registry reflection for the specified key. Disabling reflection for a key does not affect reflection of any subkeys. |
| RegEnableReflectionKey Restores registry reflection for the specified disabled key. Restoring reflection for a key does not affect reflection of any subkeys. |
| RegEnumKeyA Enumerates the subkeys of the specified open registry key. (RegEnumKeyA) |
| RegEnumKeyExA Enumerates the subkeys of the specified open registry key. The function retrieves information about one subkey each time it is called. (ANSI) |
| RegEnumKeyExW Enumerates the subkeys of the specified open registry key. The function retrieves information about one subkey each time it is called. (Unicode) |
| RegEnumKeyW Enumerates the subkeys of the specified open registry key. (RegEnumKeyW) |
| RegEnumValueA Enumerates the values for the specified open registry key. The function copies one indexed value name and data block for the key each time it is called. (ANSI) |
| RegEnumValueW Enumerates the values for the specified open registry key. The function copies one indexed value name and data block for the key each time it is called. (Unicode) |
| RegFlushKey Writes all the attributes of the specified open registry key into the registry. |
| RegGetKeySecurity Retrieves a copy of the security descriptor protecting the specified open registry key. |
| RegGetValueA Retrieves the type and data for the specified registry value. (ANSI) |
| RegGetValueW Retrieves the type and data for the specified registry value. (Unicode) |
| RegLoadAppKeyA Loads the specified registry hive as an application hive. (ANSI) |
| RegLoadAppKeyW Loads the specified registry hive as an application hive. (Unicode) |
| RegLoadKeyA Creates a subkey under HKEY_USERS or HKEY_LOCAL_MACHINE and loads the data from the specified registry hive into that subkey. (ANSI) |
| RegLoadKeyW Creates a subkey under HKEY_USERS or HKEY_LOCAL_MACHINE and loads the data from the specified registry hive into that subkey. (Unicode) |
| RegLoadMUIStringA Loads the specified string from the specified key and subkey. (ANSI) |
| RegLoadMUIStringW Loads the specified string from the specified key and subkey. (Unicode) |
| RegNotifyChangeKeyValue Notifies the caller about changes to the attributes or contents of a specified registry key. |
| RegOpenCurrentUser Retrieves a handle to the HKEY_CURRENT_USER key for the user the current thread is impersonating. |
| RegOpenKeyA Opens the specified registry key. (ANSI) |
| RegOpenKeyExA Opens the specified registry key. Note that key names are not case sensitive. (ANSI) |
| RegOpenKeyExW Opens the specified registry key. Note that key names are not case sensitive. (Unicode) |
| RegOpenKeyTransactedA Opens the specified registry key and associates it with a transaction. (ANSI) |
| RegOpenKeyTransactedW Opens the specified registry key and associates it with a transaction. (Unicode) |
| RegOpenKeyW Opens the specified registry key. (Unicode) |
| RegOpenUserClassesRoot Retrieves a handle to the HKEY_CLASSES_ROOT key for a specified user. The user is identified by an access token. |
| RegOverridePredefKey Maps a predefined registry key to the specified registry key. |
| RegQueryInfoKeyA Retrieves information about the specified registry key. (ANSI) |
| RegQueryInfoKeyW Retrieves information about the specified registry key. (Unicode) |
| RegQueryMultipleValuesA Retrieves the type and data for a list of value names associated with an open registry key. (ANSI) |
| RegQueryMultipleValuesW Retrieves the type and data for a list of value names associated with an open registry key. (Unicode) |
| RegQueryReflectionKey Determines whether reflection has been disabled or enabled for the specified key. |
| RegQueryValueA Retrieves the data associated with the default or unnamed value of a specified registry key. The data must be a null-terminated string. (ANSI) |
| RegQueryValueExA Retrieves the type and data for the specified value name associated with an open registry key. (ANSI) |
| RegQueryValueExW Retrieves the type and data for the specified value name associated with an open registry key. (Unicode) |
| RegQueryValueW Retrieves the data associated with the default or unnamed value of a specified registry key. The data must be a null-terminated string. (Unicode) |
| RegRenameKey Changes the name of the specified registry key. (RegRenameKey) |
| RegReplaceKeyA Replaces the file backing a registry key and all its subkeys with another file, so that when the system is next started, the key and subkeys will have the values stored in the new file. (ANSI) |
| RegReplaceKeyW Replaces the file backing a registry key and all its subkeys with another file, so that when the system is next started, the key and subkeys will have the values stored in the new file. (Unicode) |
| RegRestoreKeyA Reads the registry information in a specified file and copies it over the specified key. This registry information may be in the form of a key and multiple levels of subkeys. (ANSI) |
| RegRestoreKeyW Reads the registry information in a specified file and copies it over the specified key. This registry information may be in the form of a key and multiple levels of subkeys. (Unicode) |
| RegSaveKeyA Saves the specified key and all of its subkeys and values to a new file, in the standard format. (ANSI) |
| RegSaveKeyExA Saves the specified key and all of its subkeys and values to a registry file, in the specified format. (ANSI) |
| RegSaveKeyExW Saves the specified key and all of its subkeys and values to a registry file, in the specified format. (Unicode) |
| RegSaveKeyW Saves the specified key and all of its subkeys and values to a new file, in the standard format. (Unicode) |
| RegSetKeySecurity Sets the security of an open registry key. |
| RegSetKeyValueA Sets the data for the specified value in the specified registry key and subkey. (ANSI) |
| RegSetKeyValueW Sets the data for the specified value in the specified registry key and subkey. (Unicode) |
| RegSetValueA Sets the data for the default or unnamed value of a specified registry key. The data must be a text string. (ANSI) |
| RegSetValueExA Sets the data and type of a specified value under a registry key. (ANSI) |
| RegSetValueExW Sets the data and type of a specified value under a registry key. (Unicode) |
| RegSetValueW Sets the data for the default or unnamed value of a specified registry key. The data must be a text string. (Unicode) |
| RegUnLoadKeyA Unloads the specified registry key and its subkeys from the registry. (ANSI) |
| RegUnLoadKeyW Unloads the specified registry key and its subkeys from the registry. (Unicode) |
Structures
| VALENTA Contains information about a registry value. The RegQueryMultipleValues function uses this structure. (ANSI) |
| VALENTW Contains information about a registry value. The RegQueryMultipleValues function uses this structure. (Unicode) |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for