네트워크 인터페이스와 연결된 클러스터에 대한 핸들을 반환합니다. PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE 형식은 이 함수에 대한 포인터를 정의합니다.
구문
HCLUSTER GetClusterFromNetInterface(
[in] HNETINTERFACE hNetInterface
);
매개 변수
[in] hNetInterface
네트워크 인터페이스에 대한 핸들입니다.
반환 값
작업이 성공하면 함수는 네트워크 인터페이스를 소유하는 클러스터에 대한 핸들을 반환합니다.
작업이 실패하면 함수는 NULL을 반환합니다. 오류에 대한 자세한 내용은 GetLastError를 호출합니다.
설명
hNetInterface가 유효한 핸들이 되려면 반드시 열린 클러스터 핸들이 있어야 합니다(OpenClusterNetInterface 참조). GetClusterFromNetInterface는 hNetInterface를 가져온 핸들의 다른 instance 반환합니다.
핸들이 scope 나가기 전에 GetClusterFromNetInterface에서 반환된 핸들에서 CloseCluster를 호출해야 합니다. 이 핸들을 닫으면 hNetInterface 또는 hNetInterface 를 가져온 클러스터 핸들이 무효화되지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |