다음을 통해 공유


GetClusterNodeState 함수(clusapi.h)

노드의 현재 상태를 반환합니다. PCLUSAPI_GET_CLUSTER_NODE_STATE 형식은 이 함수에 대한 포인터를 정의합니다.

구문

CLUSTER_NODE_STATE GetClusterNodeState(
  [in] HNODE hNode
);

매개 변수

[in] hNode

상태 정보를 반환해야 하는 노드에 대한 핸들입니다.

반환 값

GetClusterNodeState 는 다음 값 중 하나로 표시되는 노드의 현재 상태를 반환합니다.

반환된 값은 CLUSTER_NODE_STATE 열거형에서 가져옵니다.

반환 코드/값 설명
ClusterNodeUp
0
노드는 물리적으로 연결되고, 켜져 있고, 부팅되며, 프로그램을 실행할 수 있습니다.
ClusterNodeDown
1
노드가 꺼져 있거나 작동되지 않습니다.
ClusterNodeJoining
3
노드가 클러스터를 조인하는 중입니다.
ClusterNodePaused
2
노드가 실행 중이지만 클러스터 작업에 참여하지 않습니다.
ClusterNodeStateUnknown
-1
작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다.

설명

ClusterNodeDown 상태는 노드가 비활성 상태임을 나타냅니다. 비활성 이유를 지정하지 않습니다. 노드는 다음과 같은 이유로 ClusterNodeDown 상태일 수 있습니다.

  • 노드가 실행되고 있지 않습니다.
  • 노드의 클러스터 서비스가 실행되고 있지 않습니다.
  • 노드는 쿼럼 리소스를 제어하는 노드와 통신할 수 없습니다.
  • 노드가 다른 이유로 비활성 상태입니다.
노드가 클러스터의 활성 멤버로 작동하지만 리소스 또는 그룹을 호스트할 수 없는 경우 ClusterNodePaused 상태입니다( PauseClusterNode 함수 참조). 유지 관리 중인 노드는 일반적으로 이 상태에 배치됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
대상 플랫폼 Windows
헤더 clusapi.h
라이브러리 ClusAPI.lib
DLL ClusAPI.dll

추가 정보

CLUSTER_NODE_STATE

OpenClusterNode

PauseClusterNode