Función CreateCluster (clusapi.h)

Crea e inicia un clúster. El clúster consta del conjunto de nodos especificados, con los recursos nombre de red, dirección IP y cuórum , si se especifica. El tipo PCLUSAPI_CREATE_CLUSTER define un puntero a esta función.

Syntax

HCLUSTER CreateCluster(
  [in]           PCREATE_CLUSTER_CONFIG           pConfig,
  [in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
  [in, optional] PVOID                            pvCallbackArg
);

Parámetros

[in] pConfig

Dirección de una estructura de CREATE_CLUSTER_CONFIG que contiene información de configuración sobre el clúster que se va a crear.

[in, optional] pfnProgressCallback

Dirección de la función de devolución de llamada que coincide con el puntero de función PCLUSTER_SETUP_PROGRESS_CALLBACK al que se llamará periódicamente para proporcionar progreso en la creación del clúster.

[in, optional] pvCallbackArg

Argumento para la función de devolución de llamada.

Valor devuelto

Controle al clúster recién creado o NULL. Un valor distinto de NULL no indica que se ha completado correctamente (se agregarán todos los nodos, pero no todos los recursos de dirección IP o nombre de red pueden haberse creado. Se deben comprobar los parámetros pasados a la función a la que apunta el parámetro pfnProgressCallback .

Código de retorno	Description
NULL	Se crearon correctamente menos de la mayoría de los nodos. Para obtener más información sobre el error, llame a la función GetLastError.

Observaciones

El tipo PCLUSAPI_CREATE_CLUSTER define un puntero a esta función y se puede usar con la función GetProcAddress para llamar a esta función.

Una vez completada correctamente la función CreateCluster , se deben permitir al menos 30 segundos antes de llamar a la función AddClusterNode para agregar nodos adicionales.

La función CreateCluster se completa correctamente después de que se haya logrado el cuórum del clúster. Uno o varios nodos de clúster podrían estar en un estado ClusterNodeDown o ClusterNodeJoining durante unos segundos.

Antes de llamar a la función CreateCluster , se debe llamar a la función CoInitializeEx especificando tanto COINIT_MULTITHREADED comoCOINIT_DISABLE_OLE1DDE para el parámetro dwCoInit , como se muestra en el código siguiente.

CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );

Requisitos

Requirement	Importancia
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo admitido	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
de la plataforma de destino de	Windows
Header	clusapi.h
Library	ClusAPI.lib
DLL de	ClusAPI.dll

Consulte también

AddClusterNode

CREATE_CLUSTER_CONFIG

Funciones de administración de clústeres

DestroyCluster

PCLUSTER_SETUP_PROGRESS_CALLBACK