MoveClusterGroup 함수(clusapi.h)
그룹 및 모든 리소스를 한 노드에서 다른 노드로 이동합니다. PCLUSAPI_MOVE_CLUSTER_GROUP 형식은 이 함수에 대한 포인터를 정의합니다.
DWORD MoveClusterGroup(
[in] HGROUP hGroup,
[in, optional] HNODE hDestinationNode
);
[in] hGroup
이동할 그룹에 대한 핸들입니다.
[in, optional] hDestinationNode
이동된 그룹을 다시 온라인 또는 NULL로 가져와야 하는 노드에 대한 핸들입니다.
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 오류 코드 중 하나입니다.
반환 코드 | 설명 |
---|---|
|
그룹의 소유권 재할당이 진행 중입니다. |
MoveClusterGroup 함수의 반환 값은 그룹의 상태 또는 해당 리소스에 대해 아무 것도 의미하지 않습니다. 반환 값은 소유권 변경이 성공했는지 여부만 나타냅니다. MoveClusterGroup에서 반환한 후 클러스터는 항상 이동 전 상태로 그룹을 반환하려고 시도합니다.
이동 후 애플리케이션이 리소스 또는 그룹에 대한 특정 상태를 보장하도록 하려면 다음을 수행합니다.
- 이동하기 전에 상태를 확인합니다. 클러스터는 이동 후 해당 상태를 복원하려고 시도합니다.
- 이동 후 상태를 폴링하고 필요에 따라 조정합니다. 또는 알림 포트( 클러스터 이벤트 수신 참조)를 만들고 CLUSTER_CHANGE_GROUP_STATE 이벤트를 기다립니다.
리소스 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 |