Función ClusterRegEnumValue (clusapi.h)
Enumera los valores de una clave de base de datos de clúster abierta.
Sintaxis
DWORD ClusterRegEnumValue(
[in] HKEY hKey,
[in] DWORD dwIndex,
[out] LPWSTR lpszValueName,
[in, out] LPDWORD lpcchValueName,
[out, optional] LPDWORD lpdwType,
[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 enumerar.
[in] dwIndex
Índice usado para identificar el siguiente valor que se va a enumerar. Este parámetro debe ser cero para la primera llamada a ClusterRegEnumValue y, a continuación, incrementarse para las llamadas posteriores.
Dado que los valores no están ordenados, ningún nuevo valor tiene un índice arbitrario. Esto significa que ClusterRegEnumValue puede devolver valores en cualquier orden.
[out] lpszValueName
Puntero a una cadena Unicode terminada en null que contiene el nombre del valor devuelto.
[in, out] lpcchValueName
Puntero al tamaño del búfer lpszValueName como recuento de caracteres. En la entrada, especifique el número máximo de caracteres que puede contener el búfer, incluido el valor NULL de terminación. En la salida, especifica el número de caracteres en el nombre resultante, excepto el valor NULL de terminación.
[out, optional] lpdwType
Puntero al código de tipo para la entrada de valor o NULL si no se requiere el código de tipo. El código de tipo puede ser uno de los valores 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 de la entrada de valor. Este parámetro puede ser NULL si los datos no son necesarios.
[in, out, optional] lpcbData
En la entrada, puntero a un recuento de bytes en el búfer al que apunta el parámetro lpbData . En la salida, puntero a un recuento de bytes resultantes de la operación. Este parámetro solo puede ser NULL si lpbData 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. |
|
No hay más valores que se van a devolver. |
|
Uno de los búferes de salida (lpszValueName o lpbData) es demasiado pequeño para contener los datos resultantes. Los parámetros lpcchValueName y lpbData indican el tamaño necesario (tenga en cuenta que lpcchValueName no incluye el valor NULL de terminación en el recuento de caracteres). |
| Error en la operación. |
Requisitos
| 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 |