Compartir a través de

Función OpenClusterEx (clusapi.h)

  • Artículo

Abre una conexión a un clúster y devuelve un identificador a él.

Sintaxis

HCLUSTER OpenClusterEx(
  [in, optional]  LPCWSTR lpszClusterName,
  [in]            DWORD   DesiredAccess,
  [out, optional] DWORD   *GrantedAccess
);

Parámetros

[in, optional] lpszClusterName

Especifica uno de los valores siguientes:

  • Puntero a una cadena Unicode terminada en null que contiene el nombre del clúster o uno de los nodos del clúster expresados como un nombre NetBIOS, un nombre DNS completo o una dirección IP. Esto genera un identificador de clúster RPC.
  • NULL, que genera un identificador LPC para el clúster al que pertenece el equipo local.

[in] DesiredAccess

Privilegios de acceso solicitados. Puede tratarse de cualquier combinación de GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) o MAXIMUM_ALLOWED (0x02000000). Si este valor es cero (0) y se puede devolver un error indefinido. El uso de GENERIC_ALL es el mismo que llamar a OpenCluster.

[out, optional] GrantedAccess

Parámetro opcional que contiene la dirección de un DWORD que recibirá los derechos de acceso concedidos. Si el parámetro DesiredAccess es MAXIMUM_ALLOWED (0x02000000), el DWORD al que apunta este parámetro contendrá los privilegios máximos concedidos a este usuario.

Valor devuelto

Si la operación se realizó correctamente, OpenClusterEx devuelve un identificador de clúster.

Código o valor devuelto Descripción
NULL
0
 La operación no se realizó correctamente. Para obtener más información sobre el error, llame a la función GetLastError . Si el servidor de destino no admite la función OpenClusterEx (por ejemplo, si el servidor de destino ejecuta Windows Server 2008 o versiones anteriores), la función GetLastError devolverá RPC_S_PROCNUM_OUT_OF_RANGE (1745).

Comentarios

Un identificador de clúster es un puntero a una estructura definida internamente que almacena información sobre la conexión RPC o LPC al clúster. Los identificadores de objeto obtenidos del identificador de clúster se asociarán a los datos de sesión RPC o LPC almacenados en la estructura del clúster. La combinación de identificadores RPC y LPC o el uso de identificadores obtenidos de distintos contextos puede provocar excepciones u otros resultados impredecibles. Para obtener más información, vea LPC y identificadores RPC.

Cuando termine con un identificador de clúster, es importante llamar a CloseCluster para asegurarse de que se libere toda la memoria y que la conexión se apague limpiamente.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise
Plataforma de destino Windows
Encabezado clusapi.h
Library ClusAPI.lib
Archivo DLL ClusAPI.dll