Compartir a través de

Función OpenCluster (clusapi.h)

  • Artículo

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

Sintaxis

HCLUSTER OpenCluster(
  [in, optional] LPCWSTR lpszClusterName
);

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.

Valor devuelto

Si la operación se realizó correctamente, OpenCluster 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.

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 imprevisibles. Para obtener más información, consulte LPC y controladores RPC.

Cuando termine con un identificador de clúster, es importante llamar a CloseCluster para asegurarse de que toda la memoria está libre y la conexión se apaga de forma limpia.

Si el clúster es remoto, el cliente debe ejecutar un sistema operativo compatible. Por ejemplo, los equipos que ejecutan Windows Server 2008 no pueden llamar a OpenCluster en un clúster que ejecuta Windows Server 2016. Para administrar de forma remota estos clústeres, use el proveedor WMI del clúster de conmutación por error.

Ejemplos

Consulte Uso de identificadores de objeto.

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

Consulte también

CloseCluster

Funciones de administración de clústeres de conmutación por error

OpenClusterEx