OpenCluster 함수(clusapi.h)
클러스터에 대한 연결을 열고 클러스터에 대한 핸들을 반환합니다.
구문
HCLUSTER OpenCluster(
[in, optional] LPCWSTR lpszClusterName
);
매개 변수
[in, optional] lpszClusterName
다음 값 중 하나를 지정합니다.
- 클러스터 이름 또는 NetBIOS 이름, 정규화된 DNS 이름 또는 IP 주소로 표현된 클러스터 노드 중 하나를 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다. 이렇게 하면 RPC 클러스터 핸들이 생성됩니다.
- NULL - 로컬 컴퓨터가 속한 클러스터에 대한 LPC 핸들을 생성합니다.
반환 값
작업이 성공하면 OpenCluster 는 클러스터 핸들을 반환합니다.
| 반환 코드/값 | 설명 |
|---|---|
|
작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. |
설명
클러스터 핸들은 클러스터에 대한 RPC 또는 LPC 연결에 대한 정보를 저장하는 내부적으로 정의된 구조체에 대한 포인터입니다. 클러스터 핸들에서 가져온 모든 개체 핸들은 클러스터 구조에 저장된 RPC 또는 LPC 세션 데이터와 연결됩니다. RPC 및 LPC 핸들을 결합하거나 다른 컨텍스트에서 가져온 핸들을 사용하면 예외 또는 기타 예측할 수 없는 결과가 발생할 수 있습니다. 자세한 내용은 LPC 및 RPC 핸들을 참조하세요.
클러스터 핸들로 완료되면 CloseCluster 를 호출하여 모든 메모리가 해제되고 연결이 완전히 종료되도록 하는 것이 중요합니다.
클러스터가 원격인 경우 클라이언트는 호환되는 운영 체제를 실행해야 합니다. 예를 들어 Windows Server 2008을 실행하는 컴퓨터는 Windows Server 2016 실행되는 클러스터에 대해 OpenCluster를 호출할 수 없습니다. 이러한 클러스터를 원격으로 관리하려면 장애 조치(failover) 클러스터 WMI 공급자를 사용합니다.
예제
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |