RegistrySetValue (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Registry functions

Types of written data
Handling the registry in Windows Vista (and later)
Limitations of the RegistrySetValue function

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

RegistrySetValue (Function)

In french: RegistreEcrit

Writes a value to a key in the Windows registry.

Warning The key must exist in order to write a value to it. To create a key, use RegistryCreateKey.

Example

See additional examples

// Écrire la valeur "English" dans la valeur "Langage"
// dans la clé "HKEY_CURRENT_USER\SOFTWARE\MonAppli"
ResEcriture = RegistrySetValue("HKEY_CURRENT_USER\SOFTWARE\MonAppli", ...
		"Langage", "English")

Syntax

Writing a value identified by its name into a registry Hide the details

<Result> = RegistrySetValue([<Access mode>, ] <Key path> , <Value name> , <Value> [, <Length>])

<Result>: Boolean

True if the value was written,
False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.

<Access mode>: Integer constant

Registry access mode:
registryMode32 Forced mode to access the registry as a 32-bit program.
registryMode64 Forced mode to access the registry as a 64-bit program.
registryModeAuto
(Default value) Automatic registry access mode:
a 32-bit application running on a 32-bit system manipulates the registry as a 32-bit program.
a 32-bit application running on a 64-bit system manipulates the registry from the following branch:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node
a 64-bit application running on a 64-bit system manipulates the registry as a 64-bit program.

<Key path>: Character string

Full path of key to use. This key must exists in order for a value to be given to it.

<Value name>: Character string

Name of the value to write. If the value does not exist, it will be created.

<Value>: Character string, integer, real or pointer

Value to write. This value must not directly correspond to a numeric edit control for example. A typed variable must be used (declared as real, character string, ...).

<Length>: Optional integer

Length of the value to write when <Value> corresponds to a pointer.

Writing a typed value identified by its name into a registry Hide the details

<Result> = RegistrySetValue([<Access mode>, ] <Key path> , <Value name> , <Value> , <Type of value>)

<Result>: Boolean

True if the value was written,
False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.

<Access mode>: Integer constant

Registry access mode:
registryMode32 Forced mode to access the registry as a 32-bit program.
registryMode64 Forced mode to access the registry as a 64-bit program.
registryModeAuto
(Default value) Automatic registry access mode:
a 32-bit application running on a 32-bit system manipulates the registry as a 32-bit program.
a 32-bit application running on a 64-bit system manipulates the registry from the following branch:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node
a 64-bit application running on a 64-bit system manipulates the registry as a 64-bit program.

<Key path>: Character string

Full path of key to use. This key must exists in order for a value to be given to it.

<Value name>: Character string

Name of the value to write. If the value does not exist, it will be created.

<Value>: Character string, integer, real or pointer

Value to write. If <Type of value> is used, the value is automatically converted to the right type

<Type of value>: Character String constant

Type of value to write:
registryTypeBinary Binary key. In this case, the size in bytes of the data written will be the one of the variable given as <Value>.
registryTypeInt 4-byte integer key.
registryTypeInt_8 8-byte integer key.
registryTypeIntegerBigEndian Big-endian integer key.
registryTypeMultiString Multistring key. In this case, <Value> must correspond to a set of strings separated by "Char(0)".
registryTypeString String key.
registryTypeStringEnv String key containing environment variables.

Writing a value identified by its index to a registry Hide the details

<Result> = RegistrySetValue([<Access mode>, ] <Key path> , <Value index> , <Value> [, <Length>])

<Result>: Boolean

True if the value was written,
False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.

<Access mode>: Integer constant

Registry access mode:
registryMode32 Forced mode to access the registry as a 32-bit program.
registryMode64 Forced mode to access the registry as a 64-bit program.
registryModeAuto
(Default value) Automatic registry access mode:
a 32-bit application running on a 32-bit system manipulates the registry as a 32-bit program.
a 32-bit application running on a 64-bit system manipulates the registry from the following branch:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node
a 64-bit application running on a 64-bit system manipulates the registry as a 64-bit program.

<Key path>: Character string

Full path of key to use. This key must exists in order for a value to be given to it.

<Value index>: Integer

Index of the value to be written.

<Value>: Character string, integer, real or pointer

Value to write.

<Length>: Optional integer

Length of the value to write when <Value> corresponds to a pointer.

Writing a typed value identified by its index to a registry Hide the details

<Result> = RegistrySetValue([<Access mode>, ] <Key path> , <Value index> , <Value> , <Type of value>)

<Result>: Boolean

True if the value was written,
False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.

<Access mode>: Integer constant

Registry access mode:
registryMode32 Forced mode to access the registry as a 32-bit program.
registryMode64 Forced mode to access the registry as a 64-bit program.
registryModeAuto
(Default value) Automatic registry access mode:
a 32-bit application running on a 32-bit system manipulates the registry as a 32-bit program.
a 32-bit application running on a 64-bit system manipulates the registry from the following branch:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node
a 64-bit application running on a 64-bit system manipulates the registry as a 64-bit program.

<Key path>: Character string

Full path of key to use. This key must exists in order for a value to be given to it.

<Value index>: Integer

Index of the value to be written.

<Value>: Character string, integer, real or pointer

Value to write.

<Type of value>: Character String constant

Type of value to write:
registryTypeBinary Binary key. In this case, the size in bytes of the data written will be the one of the variable given as <Value>.
registryTypeInt 4-byte integer key.
registryTypeInt_8 8-byte integer key.
registryTypeIntegerBigEndian Big-endian integer key.
registryTypeMultiString Multistring key. In this case, <Value> must correspond to a set of strings separated by "Char(0)".
registryTypeString String key.
registryTypeStringEnv String key containing environment variables.

Remarks

Types of written data

If <Type of value> is not used, the data written into the registry has a specific type according to <Value>. If <Value> corresponds to:

a character string, the value written will be a string key (REG_SZ).
an integer, the value written will be a REF_WORD.
a real or a currency, the value written will be a binary key.
a pointer, with <Length> corresponding to its length, the value written will be a binary key.

Handling the registry in Windows Vista (and later)

In Windows Vista, if the UAC mechanism is enabled, you must have administrator rights to write to the "HKEY_LOCAL_MACHINE\SOFTWARE" key.

If the user does not have sufficient rights, the UAC mechanism automatically redirects to the "HKEY_CURRENT_USER\Software\Classes\VirtualStore\MACHINE\SOFTWARE" key. The purpose of this redirection is to ensure the compatibility of the applications. The keys written in this directory can be read by the application that has written them.

Reminder When creating an executable, you can include a manifest to give the application administrator rights.

Limitations of the RegistrySetValue function

RegistrySetValue has no effect on "(default)" entries. These are specific entries. To reach these entries, the name of the key must be replaced with an empty string.

Example:

Don't:

RegistrySetValue("HKEY_CLASSES_ROOT\.jar", "(par défaut)", "myfile")

Do:

RegistrySetValue("HKEY_CLASSES_ROOT\.jar", "", "myfile")

Business / UI classification: Business Logic

Component: wd300std.dll

See also

Minimum version required

Version 9

This page is also available for…

Comments

Alter Wallpaper Windows

PROCEDURE Wallpaper()

// Alterando o Papel de parede do Windows
bAlterado is boolean = False
fMakeDir("C:\Temp\")
fCopyFile("saw.apt","sawarning.jpg")
WRegFondEcran is string = "C:\Temp\sawarning.jpg"
fCopyFile("sawarning.jpg","C:\Temp\sawarning.jpg")
WChemin is string = "HKEY_CURRENT_USER\Control Panel\Desktop"
IF RegistrySetValue (WChemin, "Wallpaper", WRegFondEcran) = False
Error("Error image")
bAlterado = False
ELSE
bAlterado = True
uAction is int
uParam is int
lpvParam is string ASCIIZ on 255
uAction = 20
uParam = 0
lpvParam = WRegFondEcran
CallDLL32("user32", "SystemParametersInfoA", uAction, uParam,&lpvParam, 0)
END

RESULT bAlterado

BOLLER

17 Apr. 2019

Example

PROCEDURE TaskManager(bEnableDisable is boolean)

//Buscar
ResExist1 is boolean = RegistryExist("HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\")
ResExist2 is boolean = RegistryExist("HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\System")

//Criar se nao existe a Pasta System
IF ResExist1 = True AND ResExist2 = False THEN
//cria a pasta da esquerda
RegistryCreateKey("HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\System")
//cria a chave DisableTaskMgr tipo DWORD 32 dentro da Pasta
RegistrySetValue("HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\System","DisableTaskMgr",0)
END

if bEnableDisable = false
RegistrySetValue("HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\System","DisableTaskMgr",1) //disable

else

RegistrySetValue("HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\System","DisableTaskMgr",0) //enable

end

BOLLER

27 Nov. 2018

Exemplo Resgistro Windows - Ler e Gravar

//-- Global
PROCEDURE MyWindow()
gn_id_usuario is int=0
//Global declarations
_chave_senha is string="HKEY_CURRENT_USER\Software\erpmatos\"
//----------------------
//--End of

//Ler Chave
n_usuario is int=RegistryQueryValue(_chave_senha,"Usuario")
CBOX_salvar=RegistryQueryValue(_chave_senha,"Salvar")
IF CBOX_salvar=True THEN
COMBO_Usuario_matos_1=n_usuario
LSV_Usuario_matos=n_usuario
s_senha is string=RegistryQueryValue(_chave_senha,"Senha")
EDT_senha = Uncrypt(s_senha, "Password")
END
//-----------------------
//Gravar Chave
//Check box Salvar
n_usuario is int=0
IF RegistryExist(_chave_senha) = False THEN
RegistryCreateKey(_chave_senha)
END
n_usuario=COMBO_Usuario_matos_1
s_nome_usuario is string=""
RegistrySetValue(_chave_senha,"Usuario",n_usuario)
RegistrySetValue(_chave_senha,"Senha",Crypt(EDT_senha,"Password"))
HReadSeekFirst(usuario_matos,usuario_matosID,n_usuario)
IF HFound(usuario_matos) THEN
RegistrySetValue(_chave_senha,"UsuarioNome",s_nome_usuario)
ELSE
RegistrySetValue(_chave_senha,"UsuarioNome","")
END
IF CBOX_salvar=True THEN
RegistrySetValue(_chave_senha,"Salvar",1)
ELSE
RegistrySetValue(_chave_senha,"Salvar",0)
END
//--
//--Botao Salvar
IF CBOX_salvar=True THEN
n_usuario is int=0
n_usuario=COMBO_Usuario_matos_1
RegistrySetValue(_chave_senha,"Usuario",n_usuario)
RegistrySetValue(_chave_senha,"Senha",Crypt(EDT_senha,"Password"))
RegistrySetValue(_chave_senha,"UsuarioNome",gs_usuario_nome)
END

//Blog Video e Exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/03/curso-windev-registro-windows-001.html

De matos AMARILDO

28 Mar. 2016

Last update: 03/27/2025

Send a report | Local help