다음을 통해 공유


ClusterResourceEnumEx 함수(clusapi.h)

리소스를 열거한 다음 현재 종속 리소스 또는 노드에 대한 포인터를 반환합니다.

구문

DWORD ClusterResourceEnumEx(
  [in]      HRESENUMEX                  hResourceEnumEx,
  [in]      DWORD                       dwIndex,
  [in, out] PCLUSTER_RESOURCE_ENUM_ITEM pItem,
  [in, out] LPDWORD                     cbItem
);

매개 변수

[in] hResourceEnumEx

ClusterResourceOpenEnumEx 함수에서 반환되는 리소스 열거형에 대한 핸들입니다.

[in] dwIndex

반환할 리소스 또는 노드 개체의 인덱스입니다. 이 매개 변수는 ClusterResourceEnumEx 함수에 대한 첫 번째 호출에 대해 0이어야 합니다.
후속 호출에 대해 증가합니다.

[in, out] pItem

반환된 개체를 수신하는 포인터입니다.

[in, out] cbItem

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

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

반환 값

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

반환 코드/값 설명
ERROR_SUCCESS
0
작업이 성공적으로 완료되거나 lpszName 매개 변수가 NULL입니다.
ERROR_MORE_DATA
234(0xEA)
lpszName 매개 변수가 가리키는 버퍼가 결과를 저장할 만큼 크지 않습니다. lpcchName 매개 변수는 종료 null 문자를 제외하고 결과의 문자 수를 반환합니다.
ERROR_NO_MORE_ITEMS
259(0x103)
반환할 개체가 더 이상 없습니다.
시스템 오류 코드
반환된 다른 오류 코드는 작업이 실패했음을 나타냅니다.

요구 사항

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

추가 정보

ClusterResourceOpenEnumEx

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