Compartir a través de

Función RegQueryMultipleValuesA (winreg.h)

  • Artículo

Recupera el tipo y los datos de una lista de nombres de valor asociados a una clave del Registro abierta.

Sintaxis

LSTATUS RegQueryMultipleValuesA(
  [in]                HKEY     hKey,
  [out]               PVALENTA val_list,
  [in]                DWORD    num_vals,
  [out, optional]     LPSTR    lpValueBuf,
  [in, out, optional] LPDWORD  ldwTotsize
);

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 clave 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_USERS

[out] val_list

Puntero a una matriz de

estructuras de VALENT que describen una o varias entradas de valor. En la entrada, el miembro ve_valuename de cada estructura debe contener un puntero al nombre de un valor que se va a recuperar. Se produce un error en la función si alguno de los valores especificados no existe en la clave especificada.

Si la función se ejecuta correctamente, cada elemento de la matriz contiene la información del valor especificado.

[in] num_vals

Número de elementos de la matriz val_list.

[out, optional] lpValueBuf

Puntero a un búfer. Si la función se realiza correctamente, el búfer recibe los datos de cada valor.

Si lpValueBuf es null, el valor al que apunta el parámetro ldwTotsize debe ser cero, en cuyo caso la función devuelve ERROR_MORE_DATA y ldwTotsize recibe el tamaño necesario del búfer, en bytes.

[in, out, optional] ldwTotsize

Puntero a una variable que especifica el tamaño del búfer al que apunta el parámetro lpValueBuf, en bytes. Si la función se ejecuta correctamente, ldwTotsize recibe el número de bytes copiados en el búfer. Si se produce un error en la función porque el búfer es demasiado pequeño, ldwTotsize recibe el tamaño necesario, en bytes.

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 uno de los siguientes códigos de error.

Código devuelto Descripción
ERROR_CANTREAD

RegQueryMultipleValues no puede crear instancias ni acceder al proveedor de la clave dinámica.
ERROR_MORE_DATA
 El búfer al que apunta lpValueBuf era demasiado pequeño. En este caso, ldwTotsize recibe el tamaño de búfer necesario.
ERROR_TRANSFER_TOO_LONG
 El tamaño total de los datos solicitados (tamaño de la matriz de val_list + ldwTotSize) es mayor que el límite del sistema de un megabyte.

Observaciones

La función regQueryMultipleValues permite a una aplicación consultar uno o varios valores de una clave estática o dinámica. Si la clave de destino es una clave estática, el sistema proporciona todos los valores de forma atómica. Para evitar una serialización excesiva, los datos agregados devueltos por la función no pueden superar un megabyte.

Si la clave de destino es una clave dinámica, su proveedor debe proporcionar todos los valores de forma atómica. Esto significa que el proveedor debe rellenar el búfer de resultados de forma sincrónica, lo que proporciona una vista coherente de todos los valores del búfer, a la vez que evita una serialización excesiva. El proveedor puede proporcionar como máximo un megabyte de datos de salida totales durante una llamada atómica a esta función.

RegQueryMultipleValues se admite de forma remota; es decir, el parámetro hKey pasado a la función puede hacer referencia a un equipo remoto.

Nota

El encabezado winreg.h define RegQueryMultipleValues 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 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
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

funciones del Registro

de información general del Registro de

VALENT