IEnumCERTVIEWCOLUMN::GetMaxLength 메서드(certview.h)

아티클
08/22/2023

GetMaxLength 메서드는 열 데이터에 대해 허용되는 최대 길이(바이트)를 검색합니다.

열 데이터의 형식이 PROPTYPE_STRING 경우 바이트 수를 기준으로 sizeof(WCHAR) 나누어 최대 유니코드 문자 수를 결정합니다.

구문

HRESULT GetMaxLength(
  [out] LONG *pMaxLength
);

매개 변수

[out] pMaxLength

열 데이터에 허용되는 최대 길이를 포함하는 LONG 형식 값에 대한 포인터입니다. pMaxLength가 NULL이면 이 함수가 실패합니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환하고 pMaxLength 는 열 데이터에 허용되는 최대 길이로 설정됩니다.

메서드가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

VB

반환 값은 열 데이터에 대해 허용되는 최대 길이(바이트)입니다.

설명

이 메서드는 현재 열거형 시퀀스에서 참조 중인 열에 대해 허용되는 최대 데이터 길이를 결정하는 데 사용됩니다.

열거형 시퀀스가 유효한 열을 참조하지 않으면 GetMaxLength 가 실패합니다. 다음 방법 중 하나를 사용하여 열거형을 탐색합니다.

IEnumCERTVIEWCOLUMN::Reset: 열거형 시퀀스의 시작 부분으로 이동합니다.
IEnumCERTVIEWCOLUMN::Next: 열거형 시퀀스의 다음 열로 이동합니다.
IEnumCERTVIEWCOLUMN::Skip: 지정된 수의 열을 건너뜁니다.

열 데이터가 인덱싱되는지 여부를 확인하려면 IEnumCERTVIEWCOLUMN::IsIndexed 메서드를 호출합니다.

예제

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
HRESULT  hr;
LONG     nLength;

// determine database length
hr = pEnumCol->GetMaxLength(&nLength);
if (S_OK == hr)
    printf("max length is %d\n", nLength);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certview.h(Certsrv.h 포함)
라이브러리	Certidl.lib
DLL	Certadm.dll