ClusterResourceTypeEnum 함수(clusapi.h)

리소스 유형의 가능한 소유자 노드 또는 리소스를 열거하고 호출당 하나의 노드 또는 리소스의 이름을 반환합니다. PCLUSAPI_CLUSTER_RESOURCE_TYPE_ENUM 형식은 이 함수에 대한 포인터를 정의합니다.

구문

DWORD ClusterResourceTypeEnum(
  [in]      HRESTYPEENUM hResTypeEnum,
  [in]      DWORD        dwIndex,
  [out]     LPDWORD      lpdwType,
  [out]     LPWSTR       lpszName,
  [in, out] LPDWORD      lpcchName
);

매개 변수

[in] hResTypeEnum

ClusterResourceTypeOpenEnum에서 반환된 리소스 종류 열거형 핸들입니다.

[in] dwIndex

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

[out] lpdwType

ClusterResourceTypeEnum에서 반환된 개체의 형식입니다. CLUSTER_RESOURCE_TYPE_ENUM 열거형의 다음 값은 유효합니다.

CLUSTER_RESOURCE_TYPE_ENUM_NODES (1)

개체는 리소스 유형의 가능한 소유자가 될 수 있는 노드입니다.

CLUSTER_RESOURCE_TYPE_ENUM_RESOURCES (2)

개체는 리소스 유형의 instance 리소스입니다.

[out] lpszName

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

[in, out] lpcchName

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

반환 값

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

반환 코드/값	설명
ERROR_SUCCESS 0	작업이 완료되었습니다.
ERROR_NO_MORE_ITEMS 259	반환할 개체가 더 이상 없습니다.
ERROR_MORE_DATA 234	lpszName에서 가리키는 버퍼는 결과를 저장할 만큼 크지 않습니다. lpcchName 매개 변수는 종료되는 NULL을 제외하고 결과의 문자 수를 반환합니다.
시스템 오류 코드	작업이 실패했습니다.

설명

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

예제

개체 열거를 참조하세요.

요구 사항

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