다음을 통해 공유


GetClusterQuorumResource 함수(clusapi.h)

클러스터의 쿼럼 리소스 이름을 반환합니다. PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE 형식은 이 함수에 대한 포인터를 정의합니다.

구문

DWORD GetClusterQuorumResource(
  [in]      HCLUSTER hCluster,
  [out]     LPWSTR   lpszResourceName,
  [in, out] LPDWORD  lpcchResourceName,
  [out]     LPWSTR   lpszDeviceName,
  [in, out] LPDWORD  lpcchDeviceName,
  [out]     LPDWORD  lpdwMaxQuorumLogSize
);

매개 변수

[in] hCluster

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

[out] lpszResourceName

클러스터의 쿼럼 리소스 이름을 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다. 이름은 쿼럼 리소스의 Name common 속성에서 읽습니다. 이 매개 변수에 대해 NULL 을 전달하지 마세요.

[in, out] lpcchResourceName

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

[out] lpszDeviceName

클러스터 서비스에서 유지 관리하는 쿼럼 로그 파일의 위치에 대한 경로를 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다. 이 매개 변수에 대해 NULL 을 전달하지 마세요.

[in, out] lpcchDeviceName

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

[out] lpdwMaxQuorumLogSize

쿼럼 리소스에서 유지 관리하는 로그의 최대 크기(바이트)에 대한 포인터입니다. 이 매개 변수에 대해 NULL 을 전달하지 마세요.

반환 값

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

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

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

설명

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

요구 사항

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

추가 정보

이름

SetClusterQuorumResource