Funzione CreateCluster (clusapi.h)
Crea e avvia un cluster. Il cluster è costituito dal set di nodi specificato, con il nome di rete, l'indirizzo IP e le risorse quorum , se specificato. Il tipo PCLUSAPI_CREATE_CLUSTER definisce un puntatore a questa funzione.
Sintassi
HCLUSTER CreateCluster(
[in] PCREATE_CLUSTER_CONFIG pConfig,
[in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
[in, optional] PVOID pvCallbackArg
);
Parametri
[in] pConfig
Indirizzo di una struttura CREATE_CLUSTER_CONFIG contenente informazioni di configurazione sul cluster da creare.
[in, optional] pfnProgressCallback
Indirizzo della funzione di callback corrispondente al puntatore a funzione PCLUSTER_SETUP_PROGRESS_CALLBACK che verrà chiamato periodicamente per fornire lo stato di avanzamento nella creazione del cluster.
[in, optional] pvCallbackArg
Argomento per la funzione di callback.
Valore restituito
Gestire il cluster appena creato o NULL. Un valore diverso da NULL non indica l'esito positivo completo.Tutti i nodi saranno stati aggiunti, ma non tutte le risorse Indirizzo IP o Nome rete potrebbero essere state create. È necessario controllare i parametri passati alla funzione a cui punta il parametro pfnProgressCallback .
| Codice restituito | Descrizione |
|---|---|
|
La creazione di una maggior parte dei nodi è stata eseguita correttamente. Per altre informazioni sull'errore, chiamare la funzione GetLastError. |
Commenti
Il tipo PCLUSAPI_CREATE_CLUSTER definisce un puntatore a questa funzione e può essere usato con la funzione GetProcAddress per chiamare questa funzione.
Al termine della funzione CreateCluster , è necessario consentire almeno 30 secondi prima che venga chiamata la funzione AddClusterNode per aggiungere nodi aggiuntivi.
La funzione CreateCluster viene completata correttamente dopo il raggiungimento del quorum del cluster. Uno o più nodi del cluster possono trovarsi in uno stato ClusterNodeDown o ClusterNodeJoining per alcuni secondi.
Prima di chiamare la funzione CreateCluster , è necessario chiamare la funzione CoInitializeEx specificando sia COINIT_MULTITHREADED cheCOINIT_DISABLE_OLE1DDE per il parametro dwCoInit , come illustrato nel codice seguente.
CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Piattaforma di destinazione | Windows |
| Intestazione | clusapi.h |
| Libreria | ClusAPI.lib |
| DLL | ClusAPI.dll |