Compartilhar via


Função GetClusterNodeState (clusapi.h)

Retorna o estado atual de um . O tipo PCLUSAPI_GET_CLUSTER_NODE_STATE define um ponteiro para essa função.

Sintaxe

CLUSTER_NODE_STATE GetClusterNodeState(
  [in] HNODE hNode
);

Parâmetros

[in] hNode

Identificador para o nó para o qual as informações de estado devem ser retornadas.

Retornar valor

GetClusterNodeState retorna o estado atual do nó, que é representado por um dos valores a seguir.

Os valores retornados são da enumeração CLUSTER_NODE_STATE .

Valor/código retornado Descrição
ClusterNodeUp
0
O nó está fisicamente conectado, ligado, inicializado e capaz de executar programas.
ClusterNodeDown
1
O nó está desativado ou não está operacional.
ClusterNodeJoining
3
O nó está no processo de ingressar em um cluster.
ClusterNodePaused
2
O nó está em execução, mas não está participando de operações de cluster.
ClusterNodeStateUnknown
-1
A operação não foi bem-sucedida. Para obter mais informações sobre o erro, chame a função GetLastError.

Comentários

O estado ClusterNodeDown indica apenas que um nó está inativo; ele não especifica o motivo da inatividade. Um nó pode estar no estado ClusterNodeDown pelos seguintes motivos:

  • O nó não está em execução.
  • O serviço cluster no nó não está em execução.
  • O nó não pode se comunicar com o nó que controla o recurso de quorum.
  • O nó está inativo por qualquer outro motivo.
Quando um nó está operando como um membro ativo de um cluster, mas não pode hospedar recursos ou grupos, ele está no estado ClusterNodePaused (consulte a função PauseClusterNode ). Nós que estão passando por manutenção normalmente são colocados nesse estado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de Destino Windows
Cabeçalho clusapi.h
Biblioteca ClusAPI.lib
DLL ClusAPI.dll

Confira também

CLUSTER_NODE_STATE

OpenClusterNode

PauseClusterNode