GetClusterInformation 함수(clusapi.h)

클러스터의 이름 및 버전을 검색합니다. PCLUSAPI_GET_CLUSTER_INFORMATION 형식은 이 함수에 대한 포인터를 정의합니다.

구문

DWORD GetClusterInformation(
  [in]            HCLUSTER             hCluster,
  [out]           LPWSTR               lpszClusterName,
  [in, out]       LPDWORD              lpcchClusterName,
  [out, optional] LPCLUSTERVERSIONINFO lpClusterInfo
);

매개 변수

[in] hCluster

클러스터에 대한 핸들입니다.

[out] lpszClusterName

hCluster로 식별된 클러스터의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in, out] lpcchClusterName

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

[out, optional] lpClusterInfo

NULL 또는 클러스터 서비스 버전을 설명하는 CLUSTERVERSIONINFO 구조체에 대한 포인터입니다. lpClusterInfo가 NULL이 아닌 경우 이 구조체의 dwVersionInfoSize 멤버를 다음과 같이 설정해야 합니다.lpClusterInfo->dwVersionInfoSize = sizeof(CLUSTERVERSIONINFO);

반환 값

작업이 성공하면 함수는 ERROR_SUCCESS (0)을 반환합니다.

작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 값 중 하나입니다.

반환 코드	설명
ERROR_MORE_DATA	lpszClusterName이 가리키는 버퍼는 결과를 저장할 만큼 크지 않습니다. lpcchClusterName 매개 변수는 종료되는 NULL을 제외하고 결과의 문자 수를 반환합니다.

설명

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

요구 사항

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

추가 정보

CLUSTERVERSIONINFO