Función ClusterRegQueryValue (clusapi.h)
Devuelve el nombre, el tipo y los componentes de datos asociados a un valor para una clave de base de datos de clúster abierta.
Sintaxis
LONG ClusterRegQueryValue(
[in] HKEY hKey,
[in] LPCWSTR lpszValueName,
[out, optional] LPDWORD lpdwValueType,
[out, optional] LPBYTE lpData,
[in, out, optional] LPDWORD lpcbData
);
Parámetros
[in] hKey
Identificador de la clave de base de datos del clúster que se va a consultar.
[in] lpszValueName
Puntero a una cadena Unicode terminada en null que contiene el nombre del valor que se va a consultar.
[out, optional] lpdwValueType
Puntero al tipo de valor de la clave. Este parámetro puede ser NULL si el tipo no es necesario; de lo contrario, el valor devuelto a través de este parámetro es uno de los siguientes.
REG_BINARY (3)
Datos binarios en cualquier formato.
REG_DWORD (4)
Número de 32 bits.
REG_DWORD_BIG_ENDIAN (5)
Número de 32 bits almacenado en formato big-endian.
REG_EXPAND_SZ (2)
Cadena Unicode terminada en null que contiene referencias no expandidas a variables de entorno (por ejemplo, "%PATH%").
REG_MULTI_SZ (6)
Secuencia de cadenas terminadas en null, terminadas por una cadena vacía (\0).
A continuación se muestra un ejemplo:
String1\0String2\0String3\0LastString\0\0
El primer \0 finaliza la primera cadena, la segunda a la última \0 finaliza la última cadena y el \0 final finaliza la secuencia. Tenga en cuenta que el terminador final debe tener en cuenta la longitud de la cadena.
REG_NONE (0)
No hay ningún tipo de valor definido.
REG_QWORD (11)
Número de 64 bits.
REG_SZ (1)
Cadena Unicode terminada en null.
[out, optional] lpData
Puntero a los datos del valor. Este parámetro puede ser NULL si los datos no son necesarios.
[in, out, optional] lpcbData
En la entrada, puntero al recuento de bytes del búfer al que apunta el parámetro lpbData . En la salida, puntero al recuento de bytes en los datos del valor, que se coloca en el contenido de lpbData si el autor de la llamada pasa un puntero válido.
El parámetro lpbData solo puede ser NULL si lpbData también es NULL.
Valor devuelto
La función devuelve uno de los valores siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
El búfer al que apunta lpbData no es lo suficientemente grande como para contener los datos del valor. ClusterRegQueryValue almacena el tamaño necesario en el contenido de lpbData. |
Comentarios
Si lpbData es NULL, la función ClusterRegQueryValue devuelve ERROR_SUCCESS y almacena el tamaño de los datos del valor en el contenido de lpbData. Esta información permite al autor de la llamada asignar correctamente un búfer para contener los datos.
Si lpdwValueType se establece en REG_SZ, REG_MULTI_SZ o REG_EXPAND_SZ, lpbData también incluye un terminador NULL .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Plataforma de destino | Windows |
| Encabezado | clusapi.h |
| Library | ClusAPI.lib |
| Archivo DLL | ClusAPI.dll |