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

아티클
03/14/2023

GetValue 메서드는 열거형 시퀀스의 현재 열에 포함된 데이터 값을 검색합니다.

구문

HRESULT GetValue(
  [in]  LONG    Flags,
  [out] VARIANT *pvarValue
);

매개 변수

[in] Flags

검색된 데이터의 출력 형식을 나타내는 식별자입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
CV_OUT_BASE64	BEGIN/END가 없는 BASE64
CV_OUT_BASE64HEADER	BEGIN CERTIFICATE 및 END CERTIFICATE를 사용하여 BASE64
CV_OUT_BASE64REQUESTHEADER	새 인증서 요청 시작 및 새 인증서 요청 종료를 사용하여 BASE64
CV_OUT_BASE64X509CRLHEADER	BEGIN X509 CRL 및 END X509 CRL을 사용한 BASE64
CV_OUT_BINARY	이진
CV_OUT_HEX	16진수 문자열
CV_OUT_HEXADDR	주소/오프셋이 있는 16진수 문자열
CV_OUT_HEXASCII	ASCII를 사용하여 16진수 문자열
CV_OUT_HEXASCIIADDR	ASCII 및 주소/오프셋이 있는 16진수 문자열

[out] pvarValue

데이터 열을 포함하는 VARIANT 형식의 값에 대한 포인터입니다. pvarValue가 NULL이면 이 메서드가 실패합니다. 이 메서드가 성공적으로 완료되면 pvarValue 에는 열의 데이터가 포함됩니다. 호출자는 이 데이터로 완료되면 VariantClear 를 호출할 책임이 있습니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환합니다.

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

VB

반환 값은 열의 데이터를 나타내는 Variant 입니다.

설명

이 메서드는 열 열거형 시퀀스에서 현재 참조되는 열의 데이터를 검색하는 데 사용됩니다.

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

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

예제

HRESULT     hr;
VARIANT     var;
SYSTEMTIME  systime;

VariantInit(&var);

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetValue(CV_OUT_HEX, &var);
if ( FAILED (hr) )
{
    printf("Failed GetValue - %x\n", hr);
    goto error;
}
switch( var.vt )
{
    case VT_EMPTY:
        printf( "VT_EMPTY\n" );
        break;
    case VT_BSTR:
        printf("%ws\n", var.bstrVal );
        break;
    case VT_DATE:
        VariantTimeToSystemTime( var.date, &systime );
        printf("%d.%d.%d %02d:%02d:%02d\n",
               systime.wMonth,
               systime.wDay,
               systime.wYear,
               systime.wHour,
               systime.wMinute,
               systime.wSecond );
        break;
    case VT_I2:
        printf("%d\n", var.iVal );
        break;
    case VT_I4:
        printf("%d\n", var.lVal );
        break;
    default:
        printf("type is:%i\n", var.vt );
        break;
}
// done processing, clear resources
VariantClear( &var );

요구 사항

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