ClusterOpenEnum 함수(clusapi.h)
클러스터의 클러스터 개체를 반복하기 위한 열거자를 엽니다. PCLUSAPI_CLUSTER_OPEN_ENUM 형식은 이 함수에 대한 포인터를 정의합니다.
구문
HCLUSENUM ClusterOpenEnum(
[in] HCLUSTER hCluster,
[in] DWORD dwType
);
매개 변수
[in] hCluster
클러스터에 대한 핸들입니다.
[in] dwType
열거할 개체의 형식을 설명하는 비트 마스크입니다. CLUSTER_ENUM 열거형의 다음 값 중 하나 이상이 유효합니다.
CLUSTER_ENUM_NODE(1(0x1))
클러스터의 노드를 열거합니다.
CLUSTER_ENUM_RESTYPE(2(0x2))
클러스터의 리소스 종류를 열거합니다.
CLUSTER_ENUM_RESOURCE(4(0x4))
클러스터의 리소스를 열거합니다.
CLUSTER_ENUM_GROUP(8(0x8))
클러스터의 그룹을 열거합니다.
CLUSTER_ENUM_NETWORK(16(0x10))
클러스터의 네트워크를 열거합니다.
CLUSTER_ENUM_NETINTERFACE(32(0x20))
클러스터의 네트워크 인터페이스를 열거합니다.
CLUSTER_ENUM_SHARED_VOLUME_RESOURCE(1073741824(0x40000000))
클러스터에서 사용하는 클러스터 공유 볼륨을 열거합니다.
CLUSTER_ENUM_INTERNAL_NETWORK(2147483648(0x80000000))
내부 통신을 위해 클러스터에서 사용하는 네트워크를 열거합니다. 네트워크는 SetClusterNetworkPriorityOrder에서 설정한 대로 가장 높은 우선 순위에서 가장 낮은 우선 순위 순으로 열거됩니다.
CLUSTER_ENUM_ALL((CLUSTER_ENUM_NODE | CLUSTER_ENUM_RESTYPE | CLUSTER_ENUM_RESOURCE | CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NETWORK | CLUSTER_ENUM_NETINTERFACE))
모든 클러스터 개체를 열거합니다.
반환 값
작업이 성공하면 ClusterOpenEnum 은 클러스터 열거자에 대한 핸들을 반환합니다.
작업이 실패하면 함수는 NULL을 반환합니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다.
설명
애플리케이션은 ClusterOpenEnum 함수를 호출하여 특정 유형의 열거자를 만듭니다.
ClusterOpenEnum 은 그룹, 노드, 리소스 종류, 리소스 또는 이러한 모든 것을 반복하기 위한 열거자를 만들 수 있습니다. 예를 들어 애플리케이션은 dwType 매개 변수에서 를 지정하여 ClusterOpenEnum을 호출하여 클러스터에 있는 모든 노드 및 그룹의 열거형을 CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NODE 가져올 수 있습니다.
ClusterOpenEnum 은 ClusterEnum 에 전달되어 각 클러스터 그룹 또는 노드에 액세스하고 ClusterCloseEnum 에 전달하여 열거자를 해제할 수 있는 핸들을 반환합니다.
예제
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |