ClusterEnumEx 함수(clusapi.h)

클러스터의 개체를 열거한 다음 클러스터 개체의 이름과 속성을 가져옵니다.

구문

DWORD ClusterEnumEx(
  [in]      HCLUSENUMEX        hClusterEnum,
  [in]      DWORD              dwIndex,
  [in, out] PCLUSTER_ENUM_ITEM pItem,
  [in, out] LPDWORD            cbItem
);

매개 변수

[in] hClusterEnum

ClusterOpenEnumEx 함수에서 반환되는 열거자에 대한 핸들입니다.

[in] dwIndex

열거할 다음 클러스터 개체를 식별하는 인덱스입니다. 이 매개 변수는 ClusterEnumEx 함수에 대한 첫 번째 호출에 대해 0이어야 하며 후속 호출에 대해 증가해야 합니다.

[in, out] pItem

반환된 클러스터 개체 속성을 수신하는 포인터입니다.

[in, out] cbItem

입력 시 pItem 매개 변수의 크기입니다.

출력에서 버퍼가 너무 작은 경우 버퍼의 필요한 크기(바이트)나 버퍼에 기록된 바이트 수입니다.

반환 값

반환 코드	설명
ERROR_NO_MORE_ITEMS	dwIndex 매개 변수는 열거형의 항목 수보다 큽습니다.
ERROR_MORE_DATA	버퍼가 너무 작습니다.
ERROR_SUCCESS	버퍼가 성공적으로 채워져 있습니다.

요구 사항

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

추가 정보

CLUSTER_ENUM_ITEM

장애 조치(failover) 클러스터 관리 함수