ClusterGroupEnum 함수(clusapi.h)

그룹의 리소스 또는 그룹의 기본 소유자인 노드 를 열거하고 각 호출을 사용하여 리소스 또는 노드의 이름을 반환합니다. PCLUSAPI_CLUSTER_GROUP_ENUM 형식은 이 함수에 대한 포인터를 정의합니다.

구문

DWORD ClusterGroupEnum(
  [in]      HGROUPENUM hGroupEnum,
  [in]      DWORD      dwIndex,
  [out]     LPDWORD    lpdwType,
  [out]     LPWSTR     lpszResourceName,
  [in, out] LPDWORD    lpcchName
);

매개 변수

[in] hGroupEnum

ClusterGroupOpenEnum 함수에서 반환된 그룹 열거형 핸들입니다.

[in] dwIndex

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

[out] lpdwType

ClusterGroupEnum에서 반환된 개체 형식에 대한 포인터입니다. 다음은 CLUSTER_GROUP_ENUM 열거형의 유효한 값입니다.

CLUSTER_GROUP_ENUM_CONTAINS (1)

개체는 그룹의 리소스 중 하나입니다.

CLUSTER_GROUP_ENUM_NODES (2)

개체는 그룹의 기본 소유자 목록에 있는 노드 중 하나입니다.

[out] lpszResourceName

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

[in, out] lpcchName

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

반환 값

함수는 다음 값 중 하나를 반환할 수 있습니다.

ERROR_NO_MORE_ITEMS 또는ERROR_MORE_DATA 값에 설명된 문제 이외의 문제로 인해 작업이 성공하지 못한 경우 ClusterGroupEnum은 시스템 오류 코드를 반환합니다.

설명

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

리소스 DLL 진입점 함수에서 ClusterGroupEnum 을 호출하지 마세요. ClusterGroupEnum은 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.

예제

개체 열거를 참조하세요.

요구 사항

추가 정보

ClusterGroupCloseEnum

ClusterGroupOpenEnum

그룹 관리 함수