Compartir a través de


Función ChangeClusterResourceGroup (clusapi.h)

Mueve un recurso de un grupo a otro. El tipo PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP define un puntero a esta función.

Sintaxis

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

Parámetros

[in] hResource

Identificador del recurso que se va a mover.

[in] hGroup

Identificador del grupo que debe recibir el recurso identificado por hResource.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, devuelve uno de los códigos de error del sistema.

Comentarios

Con la función ChangeClusterResourceGroup , tanto el grupo al que pertenece un recurso actualmente como su nuevo grupo deben ser propiedad del mismo nodo , independientemente del estado del recurso.

No llame a ChangeClusterResourceGroup desde un archivo DLL de recursos. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos. Si el recurso identificado por hResource tiene dependencias, todos los recursos de su árbol de dependencias se mueven al grupo identificado por hGroup. Por ejemplo, en la situación que se muestra en el diagrama siguiente, al cambiar el recurso B al grupo 2, se moverá todo el árbol de dependencias (recursos A, X e Y).

Diagrama que muestra el árbol de dependencias entre los recursos de un grupo de recursos de clúster, antes y después de mover un recurso a otro grupo.

No pase los identificadores LPC y RPC a la misma llamada de función. De lo contrario, la llamada generará una excepción RPC y puede tener efectos destructivos adicionales. Para obtener información sobre cómo se crean los identificadores LPC y RPC, consulte Uso de identificadores de objeto y OpenCluster.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino Windows
Encabezado clusapi.h
Library ClusAPI.lib
Archivo DLL ClusAPI.dll

Consulte también

OpenCluster

OpenClusterGroup

OpenClusterResource