Compartir a través de

Función GetClusterNodeState (clusapi.h)

  • Artículo

Devuelve el estado actual de un nodo. El tipo PCLUSAPI_GET_CLUSTER_NODE_STATE define un puntero a esta función.

Sintaxis

CLUSTER_NODE_STATE GetClusterNodeState(
  [in] HNODE hNode
);

Parámetros

[in] hNode

Identificador del nodo para el que se debe devolver información de estado.

Valor devuelto

GetClusterNodeState devuelve el estado actual del nodo, representado por uno de los valores siguientes.

Los valores devueltos proceden de la enumeración CLUSTER_NODE_STATE .

Código o valor devuelto Descripción
ClusterNodeUp
0
 El nodo está conectado físicamente, activado, arrancado y capaz de ejecutar programas.
ClusterNodeDown
1
 El nodo está desactivado o no está operativo.
ClusterNodeJoining
3
 El nodo está en proceso de unir un clúster.
ClusterNodePaused
2
 El nodo se está ejecutando pero no participando en las operaciones del clúster.
ClusterNodeStateUnknown
-1
 La operación no se realizó correctamente. Para obtener más información sobre el error, llame a la función GetLastError.

Comentarios

El estado ClusterNodeDown solo indica que un nodo está inactivo; no especifica el motivo de la inactividad. Un nodo puede estar en el estado ClusterNodeDown por los siguientes motivos:

  • El nodo no se está ejecutando.
  • El servicio de clúster en el nodo no se está ejecutando.
  • El nodo no puede comunicarse con el nodo que controla el recurso de cuórum.
  • El nodo está inactivo por cualquier otro motivo.
Cuando un nodo funciona como miembro activo de un clúster, pero no puede hospedar ningún recurso o grupo, está en estado ClusterNodePaused (consulte la función PauseClusterNode ). Los nodos que se están realizando un mantenimiento normalmente se colocan en este estado.

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

CLUSTER_NODE_STATE

OpenClusterNode

PauseClusterNode