Método RegWrite

Crea una clave nueva, agrega otro nombre de valor a una clave ya existente (y le asigna un valor) o cambia el valor de un nombre de valor ya existente.

objeto.RegWrite(cdnNombre, clqValor [,cdnTipo])

Argumentos

objeto: Objeto WshShell.
cdnNombre: Cadena que indica el nombre de clave, el nombre de valor o el valor que desea crear, agregar o cambiar.
clqValor: El nombre de la nueva clave que desea crear, el nombre del valor que desea agregar a una clave ya existente o el nuevo valor que desea asignar a un nombre de valor ya existente.
cdnTipo: Opcional. Cadena que indica el tipo de datos del valor.

Comentarios

Para especificar un nombre de clave incluya una barra diagonal inversa al final de cdnNombre. No la incluya si especifica un nombre de valor. El método RegWrite convierte automáticamente el parámetro clqValor en una cadena o en un número entero. El valor de cdnTipo determina su tipo de datos (una cadena o un entero). En la siguiente tabla se muestran los posibles valores de cdnTipo.

Se convierte en	cdnTipo
Cadena	REG_SZ
Cadena	REG_EXPAND_SZ
Entero	REG_DWORD
Entero	REG_BINARY

Nota El método RegWrite no admite el tipo REG_MULTI_SZ.

Sugerencia RegWrite escribirá como máximo un valor DWORD en un valor REG_BINARY. Este método no admite valores mayores.

Los nombres de clave y nombres de valor completos tienen como prefijo una clave principal. Puede usar versiones abreviadas de los nombres de las claves principales con el método RegWrite. Las cinco claves principales se muestran en la siguiente tabla.

Nombre de la clave principal	Abreviatura
HKEY_CURRENT_USER	HKCU
HKEY_LOCAL_MACHINE	HKLM
HKEY_CLASSES_ROOT	HKCR
HKEY_USERS	HKEY_USERS
HKEY_CURRENT_CONFIG	HKEY_CURRENT_CONFIG

En la siguiente tabla se muestran los cuatro tipos de datos que se pueden especificar con cdnTipo.

Tipo	Descripción	Con el formato de
REG_SZ	Una cadena	Una cadena
REG_DWORD	Un número	Un entero
REG_BINARY	Un valor binario	Un VBArray de enteros
REG_EXPAND_SZ	Una cadena expandible (p. ej., "%windir%\\calc.exe")	Una cadena

Ejemplo

El siguiente código crea una clave y dos valores, los lee y los elimina.

[VBScript]

Dim WshShell, bKey
Set WshShell = WScript.CreateObject("WScript.Shell")

WshShell.RegWrite "HKCU\Software\ACME\Adivina\", 1, "REG_BINARY"
WshShell.RegWrite "HKCU\Software\ACME\Adivina\LeeLaMente", "¡De verdad!", "REG_SZ"

bKey = WshShell.RegRead("HKCU\Software\ACME\Adivina\")
WScript.Echo WshShell.RegRead("HKCU\Software\ACME\Adivina\LeeLaMente")

WshShell.RegDelete "HKCU\Software\ACME\Adivina\LeeLaMente"
WshShell.RegDelete "HKCU\Software\ACME\Adivina\"
WshShell.RegDelete "HKCU\Software\ACME\"

[JScript]

var WshShell = WScript.CreateObject("WScript.Shell");

WshShell.RegWrite ("HKCU\\Software\\ACME\\Adivina\\", 1, "REG_BINARY");
WshShell.RegWrite ("HKCU\\Software\\ACME\\Adivina\\LeeLaMente", "¡De verdad!", "REG_SZ");

var bKey =    WshShell.RegRead ("HKCU\\Software\\ACME\\Adivina\\");
WScript.Echo (WshShell.RegRead ("HKCU\\Software\\ACME\\Adivina\\LeeLaMente"));

WshShell.RegDelete ("HKCU\\Software\\ACME\\Adivina\\LeeLaMente");
WshShell.RegDelete ("HKCU\\Software\\ACME\\Adivina\\");
WshShell.RegDelete ("HKCU\\Software\\ACME\\");

Consulte también

Objeto WshShell | Método RegDelete | Método RegRead