Compartir a través de

Función MoveClusterGroup (clusapi.h)

  • Artículo

Mueve un grupo y todos sus recursos de un nodo a otro. El tipo PCLUSAPI_MOVE_CLUSTER_GROUP define un puntero a esta función.

Sintaxis

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

Parámetros

[in] hGroup

Identificador del grupo que se va a mover.

[in, optional] hDestinationNode

Controle al nodo donde se debe devolver el grupo movido en línea o NULL.

Valor devuelto

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

Si se produce un error en la operación, la función devuelve un código de error del sistema. A continuación se muestra uno de los posibles códigos de error.

Código devuelto Descripción
ERROR_IO_PENDING
 La reasignación de la propiedad del grupo está en curso.

Comentarios

El valor devuelto de la función MoveClusterGroup no implica nada sobre el estado del grupo ni de ninguno de sus recursos. El valor devuelto solo indica si el cambio de propiedad se realizó correctamente. Después de volver desde MoveClusterGroup, el clúster siempre intenta devolver el grupo al estado que tenía antes del traslado.

Si desea que la aplicación asegúrese de un estado determinado para un recurso o un grupo después de un traslado:

  1. Compruebe el estado antes del movimiento. El clúster intentará restaurar ese estado después del traslado.
  2. Sondee el estado después del movimiento y ajuste según sea necesario. O bien, cree un puerto de notificación (consulte Recepción de eventos de clúster) y espere un evento de CLUSTER_CHANGE_GROUP_STATE .
Cuando hDestinationNode se establece en NULL, MoveClusterGroup intenta mover el grupo al mejor nodo posible. Si no hay ningún nodo disponible que pueda aceptar el grupo, se produce un error en la función. MoveClusterGroup también produce un error si MoveClusterGroup determina que el grupo no se puede poner en línea en el nodo identificado por el parámetro hDestinationNode .

No llame a MoveClusterGroup desde un archivo DLL de recursos. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

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

OpenClusterNode