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 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 값 중 하나입니다.
반환 코드 | 설명 |
---|---|
|
lpszResourceName 또는 lpszDeviceName 버퍼가 결과를 저장할 만큼 크지 않습니다. lpcchResourceName 및 lpcchDeviceName 매개 변수는 종료되는 NULL을 제외하고 결과의 문자 수를 반환합니다. |
설명
lpcchName은 바이트 수가 아닌 문자 수를 나타내며 반환된 크기에는 종료되는 NULL이 개수에 포함되지 않습니다. 버퍼 크기 조정에 대한 자세한 내용은 데이터 크기 규칙을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | 지원되는 버전 없음 |
지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
대상 플랫폼 | Windows |
헤더 | clusapi.h |
라이브러리 | ClusAPI.lib |
DLL | ClusAPI.dll |