Condividi tramite


Funzione ChangeClusterResourceGroup (clusapi.h)

Sposta una risorsa da un gruppo a un'altra. Il tipo PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP definisce un puntatore a questa funzione.

Sintassi

DWORD ChangeClusterResourceGroup(
  [in] HRESOURCE hResource,
  [in] HGROUP    hGroup
);

Parametri

[in] hResource

Handle della risorsa da spostare.

[in] hGroup

Handle del gruppo che deve ricevere la risorsa identificata da hResource.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, restituisce uno dei codici di errore di sistema.

Commenti

Con la funzione ChangeClusterResourceGroup , sia il gruppo a cui appartiene una risorsa che il nuovo gruppo deve essere di proprietà dello stesso nodo indipendentemente dallo stato della risorsa.

Non chiamare ChangeClusterResourceGroup da una DLL di risorse. Per altre informazioni, vedere Chiamate di funzione per evitare nelle DLL delle risorse. Se la risorsa identificata da hResource ha dipendenze, tutte le risorse nell'albero delle dipendenze vengono spostate nel gruppo identificato da hGroup. Ad esempio, nella situazione illustrata nel diagramma seguente, la modifica della risorsa B al gruppo 2 sposta l'intero albero delle dipendenze (risorse A, X e Y).

Diagramma che mostra l'albero delle dipendenze tra le risorse in un gruppo di risorse cluster, prima e dopo che una risorsa viene spostata in un altro gruppo.

Non passare i 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 sul modo in cui vengono creati handle LPC e RPC, vedere Uso di Handle oggetti 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

OpenClusterResource