ClusterEnum 함수(clusapi.h)

아티클
08/22/2023

클러스터의 클러스터 개체 를 열거하고 각 호출을 사용하여 하나의 개체의 이름을 반환합니다. PCLUSAPI_CLUSTER_ENUM 형식은 이 함수에 대한 포인터를 정의합니다.

구문

DWORD ClusterEnum(
  [in]      HCLUSENUM hEnum,
  [in]      DWORD     dwIndex,
  [out]     LPDWORD   lpdwType,
  [out]     LPWSTR    lpszName,
  [in, out] LPDWORD   lpcchName
);

매개 변수

[in] hEnum

ClusterOpenEnum 함수에서 반환된 클러스터 열거형 핸들입니다.

[in] dwIndex

열거할 다음 항목을 식별하는 데 사용되는 인덱스입니다. 이 매개 변수는 ClusterEnum 에 대한 첫 번째 호출에 대해 0이어야 하고 후속 호출에 대해 증가해야 합니다.

[out] lpdwType

반환된 개체의 형식에 대한 포인터입니다. 각 호출과 함께 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))

클러스터에서 사용하는 클러스터 공유 볼륨을 열거합니다.

참고 대부분의 다른 열거형 비트 마스크와 달리 이 값은 단독으로 사용해야 합니다. OR 연산자를 사용하여 다른 비트 마스크와 결합하지 마세요.

Windows Server 2008: windows Server 2008 R2 이전에는 CLUSTER_ENUM_SHARED_VOLUME_RESOURCE 값이 지원되지 않습니다.

CLUSTER_ENUM_INTERNAL_NETWORK(2147483648(0x80000000))

내부 통신을 위해 클러스터에서 사용하는 네트워크를 열거합니다. 네트워크는 SetClusterNetworkPriorityOrder 함수에 의해 설정된 대로 가장 높은 우선 순위에서 가장 낮은 우선 순위 순으로 열거됩니다.

참고 대부분의 다른 열거형 비트 마스크와 달리 이 값은 단독으로 사용해야 합니다. OR 연산자를 사용하여 다른 비트 마스크와 결합하지 마세요.

CLUSTER_ENUM_ALL((CLUSTER_ENUM_NODE | CLUSTER_ENUM_RESTYPE | CLUSTER_ENUM_RESOURCE | CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NETWORK | CLUSTER_ENUM_NETINTERFACE))

모든 클러스터 개체를 열거합니다.

[out] lpszName

반환된 개체의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in, out] lpcchName

문자 수로 lpszName 버퍼의 크기에 대한 포인터입니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 지정합니다.

반환 값

함수는 다음 값 중 하나를 반환합니다.

반환 코드/값	설명
ERROR_SUCCESS 0	작업이 성공적으로 완료되었습니다.
ERROR_NO_MORE_ITEMS 259(0x103)	사용 가능한 데이터가 더 이상 없습니다. 이 값은 반환할 요청된 형식의 개체가 더 이상 없으면 반환됩니다.
ERROR_MORE_DATA 234(0xEA)	추가 데이터를 사용할 수 있습니다. lpszName이 가리키는 버퍼가 결과를 저장할 만큼 크지 않은 경우 이 값이 반환됩니다. lpcchName 매개 변수는 종료되는 NULL을 제외하고 결과의 문자 수를 반환합니다.

설명

ClusterEnum 함수는 일반적으로 하나 이상의 형식의 클러스터 개체 컬렉션을 반복하는 데 사용됩니다. 예를 들어 애플리케이션이 클러스터의 모든 노드 를 열거하려는 경우 ClusterOpenEnum 을 호출하여 노드를 처리할 수 있는 클러스터 열거자를 엽니다. dwType 매개 변수는 CLUSTER_ENUM_NODE 노드를 열거할 개체 형식으로 지정하도록 설정됩니다. 애플리케이션이 노드 외에 그룹을 열거하는 경우 dwType 매개 변수는 로 CLUSTER_ENUM_NODE | CLUSTER_ENUM_GROUP설정됩니다. ClusterOpenEnum이 반환하는 핸들을 사용하여 애플리케이션은 ClusterEnum을 반복적으로 호출하여 각 개체를 검색합니다. lpdwType 매개 변수는 검색되는 개체의 형식을 가리킵니다.

lpcchName은 바이트 수가 아닌 문자 수를 나타내며 반환된 크기에는 종료되는 NULL이 개수에 포함되지 않습니다. 버퍼 크기 조정에 대한 자세한 내용은 데이터 크기 규칙을 참조하세요.

예제

개체 열거를 참조하세요.

요구 사항


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

추가 정보

ClusterCloseEnum

ClusterOpenEnum

SetClusterNetworkPriorityOrder

다음을 통해 공유