Funzione MoveClusterGroup (clusapi.h)

Articolo
02/26/2024

Sposta un gruppo e tutte le relative risorse da un nodo a un altro. Il tipo PCLUSAPI_MOVE_CLUSTER_GROUP definisce un puntatore a questa funzione.

Sintassi

DWORD MoveClusterGroup(
  [in]           HGROUP hGroup,
  [in, optional] HNODE  hDestinationNode
);

Parametri

[in] hGroup

Handle per il gruppo da spostare.

[in, optional] hDestinationNode

Gestire il nodo in cui il gruppo spostato deve essere riportato online o NULL.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS.

Se l'operazione non riesce, la funzione restituisce un codice di errore di sistema. Di seguito è riportato uno dei possibili codici di errore.

Codice restituito	Descrizione
ERROR_IO_PENDING	La riassegnazione della proprietà del gruppo è in corso.

Commenti

Il valore restituito dalla funzione MoveClusterGroup non implica nulla sullo stato del gruppo o sulle relative risorse. Il valore restituito indica solo se la modifica della proprietà è riuscita. Dopo la restituzione da MoveClusterGroup, il cluster tenta sempre di restituire il gruppo allo stato precedente allo spostamento.

Se si vuole che l'applicazione assicuri uno stato specifico per una risorsa o un gruppo dopo uno spostamento:

Controllare lo stato prima dello spostamento. Il cluster tenterà di ripristinare lo stato dopo lo spostamento.
Eseguire il polling dello stato dopo lo spostamento e regolare in base alle esigenze. In alternativa, creare una porta di notifica (vedere Ricezione di eventi del cluster) e attendere un evento di CLUSTER_CHANGE_GROUP_STATE .

Quando hDestinationNode è impostato su NULL, MoveClusterGroup tenta di spostare il gruppo nel nodo migliore possibile. Se non è disponibile alcun nodo in grado di accettare il gruppo, la funzione ha esito negativo. MoveClusterGroup ha esito negativo anche se MoveClusterGroup determina che il gruppo non può essere portato online nel nodo identificato dal parametro hDestinationNode .

Non chiamare MoveClusterGroup da una DLL della risorsa. Per altre informazioni, vedere Chiamate di funzione da evitare nelle DLL delle risorse.

Non passare handle LPC e RPC alla stessa chiamata di funzione. In caso contrario, la chiamata genererà un'eccezione RPC e può avere effetti distruttivi aggiuntivi. Per informazioni sulla creazione di handle LPC e RPC, vedere Using Object Handle e OpenCluster.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll

Vedi anche

OpenCluster

OpenClusterGroup

OpenClusterNode

Condividi tramite