Función ORSetValue
Establece los datos para el valor de una clave del Registro especificada en un subárbol del Registro sin conexión.
Sintaxis
DWORD ORSetValue(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpValueName,
_In_ DWORD dwType,
_In_opt_ const BYTE *lpData,
_In_ DWORD cbData
);
Parámetros
-
Identificador [in]
-
Identificador de una clave del Registro abierta en un subárbol del registro sin conexión.
-
lpValueName [in, opcional]
-
Nombre del valor que se va a establecer. Si un valor con este nombre aún no está presente en la clave, la función la agrega a la clave.
Si lpValueName es NULL o una cadena vacía, "", la función establece el tipo y los datos para el valor predeterminado o sin nombre de la clave.
Para obtener más información, vea Límites de tamaño de elemento del Registro.
Las claves del Registro no tienen valores predeterminados, pero pueden tener un valor sin nombre, que puede ser de cualquier tipo.
-
dwType [in]
-
Tipo de datos al que apunta el parámetro lpData . Para obtener una lista de los posibles tipos, consulte Tipos de valor del Registro.
-
lpData [in, opcional]
-
Datos que se van a almacenar.
En el caso de los tipos basados en cadenas, como REG_SZ, la cadena debe terminar en null. Para el tipo de datos REG_MULTI_SZ, la cadena debe terminarse con dos caracteres NULL.
-
cbData [in]
-
Tamaño de la información a la que apunta el parámetro lpData , en bytes. Si los datos son de tipo REG_SZ, REG_EXPAND_SZ o REG_MULTI_SZ, cbData debe incluir el tamaño del carácter o caracteres nulos de terminación.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si la función no se ejecuta correctamente, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error.
Observaciones
Los tamaños de valor están limitados por la memoria disponible. Los valores largos (más de 2048 bytes) deben almacenarse como archivos con los nombres de archivo almacenados en el Registro. Esto ayuda al registro a realizar de forma eficaz. Los elementos de aplicación, como iconos, mapas de bits y archivos ejecutables, deben almacenarse como archivos y no colocarse en el registro.
Requisitos
| Requisito | Value |
|---|---|
| Redistribuible |
Biblioteca del Registro sin conexión de Windows versión 1.0 o posterior |
| Encabezado |
|
| Archivo DLL |
|
Consulte también