Función ClusterRegSetValue (clusapi.h)
Establece un valor para una clave de base de datos de clúster .
Sintaxis
DWORD ClusterRegSetValue(
[in] HKEY hKey,
[in] LPCWSTR lpszValueName,
[in] DWORD dwType,
[in] const BYTE *lpData,
[in] DWORD cbData
);
Parámetros
[in] hKey
Identificador de una clave de base de datos de clúster.
[in] lpszValueName
Puntero a una cadena Unicode terminada en null que contiene el nombre del valor que se va a establecer. Si un valor con este nombre aún no está presente en el recurso, ClusterRegSetValue lo agrega al recurso.
[in] dwType
Tipo de información que se va a almacenar como datos del valor. Este parámetro puede ser uno de los valores siguientes. Para obtener más información, vea Tipos de valor del Registro.
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.
[in] lpData
Puntero a los datos que se van a almacenar con el nombre al que apunta lpszValueName.
[in] cbData
Recuento de bytes en los datos a los que apunta el parámetro lpbData . Si los datos son de tipo REG_SZ, REG_EXPAND_SZ o REG_MULTI_SZ, cbData debe incluir el tamaño del carácter de terminación null.
Valor devuelto
Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS.
Si se produce un error en la operación, la función devuelve un código de error del sistema.
Comentarios
No llame a ClusterRegSetValue desde las siguientes funciones de punto de entrada dll de recursos:
ClusterRegSetValue se puede llamar de forma segura desde cualquier otra función de punto de entrada dll de recurso o desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.
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 |