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.
Sintaxis
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 el 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 devuelto | Descripción |
|---|---|
|
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. |
Comentarios
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 COINIT_MULTITHREADED y COINIT_DISABLE_OLE1DDE para el parámetro dwCoInit , como se muestra en el código siguiente.
CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Plataforma de destino | Windows |
| Encabezado | clusapi.h |
| Library | ClusAPI.lib |
| Archivo DLL | ClusAPI.dll |