영어로 읽기

다음을 통해 공유


MoveClusterGroup 함수(clusapi.h)

그룹 및 모든 리소스를 한 노드에서 다른 노드로 이동합니다. PCLUSAPI_MOVE_CLUSTER_GROUP 형식은 이 함수에 대한 포인터를 정의합니다.

구문

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

매개 변수

[in] hGroup

이동할 그룹에 대한 핸들입니다.

[in, optional] hDestinationNode

이동된 그룹을 다시 온라인 또는 NULL로 가져와야 하는 노드에 대한 핸들입니다.

반환 값

작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.

작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 오류 코드 중 하나입니다.

반환 코드 설명
ERROR_IO_PENDING
그룹의 소유권 재할당이 진행 중입니다.

설명

MoveClusterGroup 함수의 반환 값은 그룹의 상태 또는 해당 리소스에 대해 아무 것도 의미하지 않습니다. 반환 값은 소유권 변경이 성공했는지 여부만 나타냅니다. MoveClusterGroup에서 반환한 후 클러스터는 항상 이동 전 상태로 그룹을 반환하려고 시도합니다.

이동 후 애플리케이션이 리소스 또는 그룹에 대한 특정 상태를 보장하도록 하려면 다음을 수행합니다.

  1. 이동하기 전에 상태를 확인합니다. 클러스터는 이동 후 해당 상태를 복원하려고 시도합니다.
  2. 이동 후 상태를 폴링하고 필요에 따라 조정합니다. 또는 알림 포트( 클러스터 이벤트 수신 참조)를 만들고 CLUSTER_CHANGE_GROUP_STATE 이벤트를 기다립니다.
hDestinationNodeNULL로 설정된 경우 MoveClusterGroup은 그룹을 최상의 노드로 이동하려고 시도합니다. 그룹을 수락할 수 있는 사용 가능한 노드가 없으면 함수가 실패합니다. MoveClusterGrouphDestinationNode 매개 변수로 식별된 노드에서 그룹을 온라인으로 전환할 수 없다고 판단하면 MoveClusterGroup도 실패합니다.

리소스 DLL에서 MoveClusterGroup 을 호출하지 마세요. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.

LPC 및 RPC 핸들을 동일한 함수 호출에 전달하지 마세요. 그렇지 않으면 호출은 RPC 예외를 발생시키고 추가적인 파괴적인 영향을 미칠 수 있습니다. LPC 및 RPC 핸들을 만드는 방법에 대한 자세한 내용은 개체 핸들OpenCluster 사용을 참조하세요.

요구 사항

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

추가 정보

OpenCluster

OpenClusterGroup

OpenClusterNode