GetClusterGroupState 함수(clusapi.h)

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

구문

CLUSTER_GROUP_STATE GetClusterGroupState(
  [in]                HGROUP  hGroup,
  [out, optional]     LPWSTR  lpszNodeName,
  [in, out, optional] LPDWORD lpcchNodeName
);

매개 변수

[in] hGroup

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

[out, optional] lpszNodeName

현재 그룹을 소유하고 있는 노드의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in, out, optional] lpcchNodeName

lpszNodeName 버퍼의 크기를 문자 수로 가리키는 포인터입니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 지정합니다.

반환 값

GetClusterGroupState 는 다음 값 중 하나로 표시되는 그룹의 현재 상태를 반환합니다.

반환 코드/값	설명
ClusterGroupStateUnknown -1	작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다.
ClusterGroupOnline 0	그룹의 모든 리소스가 온라인 상태입니다.
ClusterGroupOffline 1	그룹의 모든 리소스가 오프라인 이거나 그룹에 리소스가 없습니다.
ClusterGroupFailed 2	그룹에서 하나 이상의 리소스가 실패했습니다(CLUSTER_RESOURCE_STATE 열거형에서 ClusterResourceFailed의 상태를 설정).
ClusterGroupPartialOnline 3	그룹에 있는 리소스 중 적어도 하나가 온라인입니다. 보류 중이거나 실패한 리소스가 없습니다.
ClusterGroupPending 4	그룹에 있는 리소스 중 적어도 하나가 보류 상태입니다. 실패한 리소스는 없습니다.

설명

lpcchName은 바이트 수가 아닌 문자 수를 나타내며 반환된 크기에는 종료되는 NULL이 개수에 포함되지 않습니다. 버퍼 크기 조정에 대한 자세한 내용은 데이터 크기 규칙을 참조하세요.

리소스 DLL 진입점 함수에서 GetClusterGroupState 를 호출하지 마세요. GetClusterGroupState 는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.

요구 사항

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