Función RegGetValueA (winreg.h)
Recupera el tipo y los datos del valor del Registro especificado.
Sintaxis
LSTATUS RegGetValueA(
[in] HKEY hkey,
[in, optional] LPCSTR lpSubKey,
[in, optional] LPCSTR lpValue,
[in, optional] DWORD dwFlags,
[out, optional] LPDWORD pdwType,
[out, optional] PVOID pvData,
[in, out, optional] LPDWORD pcbData
);
Parámetros
[in] hkey
Identificador de una clave del Registro abierta. La clave debe haberse abierto con el derecho de acceso KEY_QUERY_VALUE. Para obtener más información, consulte Derechos de acceso y seguridad de claves del Registro.
Este identificador lo devuelve el RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyExo función RegOpenKeyTransacted. También puede ser una de las siguientes claves predefinidas:
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_PERFORMANCE_DATA
- HKEY_PERFORMANCE_NLSTEXT
- HKEY_PERFORMANCE_TEXT
- HKEY_USERS
[in, optional] lpSubKey
Ruta de acceso de una clave del Registro relativa a la clave especificada por el parámetro hkey . El valor del Registro se recuperará de esta subclave.
La ruta de acceso no distingue mayúsculas de minúsculas.
Si este parámetro es NULL o una cadena vacía, "", el valor se leerá de la clave especificada por clave hkey.
[in, optional] lpValue
Nombre del valor del Registro.
Si este parámetro es null o una cadena vacía, "", la función recupera el tipo y los datos del valor predeterminado o sin nombre de la clave, si existe. Las claves no tienen automáticamente un valor predeterminado o sin nombre, y los valores sin nombre pueden ser de cualquier tipo.
Para obtener más información, consulte límites de tamaño de elemento del Registro .
[in, optional] dwFlags
Marcas que restringen el tipo de datos de valor que se va a consultar. Si el tipo de datos del valor no cumple estos criterios, se produce un error en la función. Este parámetro puede ser uno o varios de los siguientes valores.
Este parámetro también puede incluir uno o varios de los valores siguientes.
| Valor | Significado |
|---|---|
|
No expanda automáticamente las cadenas de entorno si el valor es de tipo REG_EXPAND_SZ. |
|
Si pvData no es NULL, establezca el contenido del búfer en ceros en caso de error. |
|
Si lpSubKey no es NULL, abra la subclave que lpSubKey especifica con los derechos de acceso KEY_WOW64_64KEY.
Para obtener información sobre estos derechos de acceso, consulte Derechos de acceso y seguridad de claves del Registro.
No se puede especificar RRF_SUBKEY_WOW6464KEY en combinación con RRF_SUBKEY_WOW6432KEY. |
|
Si lpSubKey no es NULL, abra la subclave que lpSubKey especifica con los derechos de acceso KEY_WOW64_32KEY.
Para obtener información sobre estos derechos de acceso, consulte Derechos de acceso y seguridad de claves del Registro.
No se puede especificar RRF_SUBKEY_WOW6432KEY en combinación con RRF_SUBKEY_WOW6464KEY. |
[out, optional] pdwType
Puntero a una variable que recibe un código que indica el tipo de datos almacenados en el valor especificado. Para obtener una lista de los posibles códigos de tipo, consulte Tipos de valor del Registro. Este parámetro puede ser null si no se requiere el tipo.
[out, optional] pvData
Puntero a un búfer que recibe los datos del valor. Este parámetro puede ser null si no se necesitan los datos.
Si los datos son una cadena, la función comprueba si hay una terminación carácter null. Si no se encuentra uno, la cadena se almacena con un terminador de null si el búfer es lo suficientemente grande como para acomodar el carácter adicional. De lo contrario, se produce un error en la función y se devuelve ERROR_MORE_DATA.
[in, out, optional] pcbData
Puntero a una variable que especifica el tamaño del búfer al que apunta el parámetro pvData, en bytes. Cuando la función devuelve, esta variable contiene el tamaño de los datos copiados en pvData.
El parámetro pcbData puede ser NULL solo si pvData es NULL.
Si los datos tienen el tipo REG_SZ, REG_MULTI_SZ o REG_EXPAND_SZ, este tamaño incluye cualquier terminación carácter o caracteres nulos caracteres. Para obtener más información, vea Comentarios.
Si el búfer especificado por parámetro pvData no es lo suficientemente grande como para contener los datos, la función devuelve ERROR_MORE_DATA y almacena el tamaño de búfer necesario en la variable a la que apunta pcbData. En este caso, el contenido del búfer de pvData son ceros si dwFlags especifica RRF_ZEROONFAILURE y sin definir de lo contrario.
Si pvData es null, y pcbData no esNULL, la función devuelve ERROR_SUCCESS y almacena el tamaño de los datos, en bytes, en la variable a la que apunta pcbData. Esto permite a una aplicación determinar la mejor manera de asignar un búfer para los datos del valor.
Si hKey especifica HKEY_PERFORMANCE_DATA y el búfer de pvData no es lo suficientemente grande como para contener todos los datos devueltos, la función devuelve ERROR_MORE_DATA y el valor devuelto a través del parámetro pcbData no está definido. Esto se debe a que el tamaño de los datos de rendimiento puede cambiar de una llamada a la siguiente. En este caso, debe aumentar el tamaño del búfer y llamar a RegGetValue pasar de nuevo el tamaño de búfer actualizado en el parámetro pcbData. Repita esto hasta que la función se realice correctamente. Debe mantener una variable independiente para realizar un seguimiento del tamaño del búfer, ya que el valor devuelto por pcbData es impredecible.
Valor devuelto
Si la función se ejecuta correctamente, se ERROR_SUCCESS el valor devuelto.
Si se produce un error en la función, el valor devuelto es un código de error del sistema .
Si el búfer de pvData es demasiado pequeño para recibir el valor, la función devuelve ERROR_MORE_DATA.
Si el valor del registro lpValue no existe, la función devuelve ERROR_FILE_NOT_FOUND.
Si dwFlags especifica una combinación de RRF_SUBKEY_WOW6464KEY y RRF_SUBKEY_WOW6432KEY, la función devuelve ERROR_INVALID_PARAMETER.
Observaciones
Normalmente, una aplicación llama a RegEnumValue para determinar los nombres de valor y, a continuación, RegGetValue para recuperar los datos de los nombres.
Si los datos tienen el tipo REG_SZ, REG_MULTI_SZ o REG_EXPAND_SZ, y se usa la versión ANSI de esta función (ya sea llamando explícitamente a RegGetValueA o no definiendo UNICODE antes de incluir el archivo Windows.h), esta función convierte la cadena Unicode almacenada en una cadena ANSI antes de copiarla en el búfer al que apunta pvData.
Al llamar a esta función con hkey establecida en el identificador de HKEY_PERFORMANCE_DATA y una cadena de valor de un objeto especificado, la estructura de datos devuelta a veces tiene objetos no requestados. No se sorprenda; este es un comportamiento normal. Siempre debe esperar recorrer la estructura de datos devuelta para buscar el objeto solicitado.
Tenga en cuenta que las operaciones que acceden a determinadas claves del Registro se redirigen. Para obtener más información, vea de virtualización del Registro y datos de aplicación de 32 y 64 bits en el Registro.
Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o posterior. Para obtener más información, vea Using the Windows Headers.
Nota
El encabezado winreg.h define RegGetValue como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista, Windows XP Professional x64 Edition |
| servidor mínimo admitido | Windows Server 2008, Windows Server 2003 con SP1 |
| de la plataforma de destino de |
Windows |
| encabezado de |
winreg.h (incluya Windows.h) |
| biblioteca de |
Advapi32.lib |
| DLL de |
Advapi32.dll |
Consulte también
RegQueryInfoKey de
de información general del Registro de