Share via

ICertRequest2::GetCAProperty 메서드(certcli.h)

  • 아티클

GetCAProperty 메서드는 CA(인증 기관)에 대한 속성 값을 검색합니다. 이 메서드의 기능은 ICertAdmin2::GetCAProperty와 동일합니다. 이 메서드에 대한 자세한 내용은 ICertAdmin2::GetCAProperty를 참조하세요.

구문

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

매개 변수

[in] strConfig

COMPUTERNAME\CANAME 형식의 CA에 대한 유효한 구성 문자열을 나타냅니다. 여기서 COMPUTERNAME은 인증서 서비스 서버의 네트워크 이름이고 CANAME는 인증서 서비스 설정 중에 입력한 대로 CA의 일반 이름입니다. 구성 문자열 이름에 대한 자세한 내용은 ICertConfig를 참조하세요.

[in] PropId

속성 식별자를 지정합니다. 이 매개 변수에 대한 자세한 내용은 ICertAdmin2::GetCAProperty의 테이블을 참조하세요.

[in] PropIndex

PropId가 인덱싱되면 속성 값을 검색할 때 사용할 0부터 시작하는 인덱스입니다. PropId가 인덱싱되지 않으면 이 값은 무시됩니다.

[in] PropType

PropId 테이블의 Type 열에 해당하는 속성의 형식을 지정합니다. 형식은 다음 형식 중 하나일 수 있습니다.

값 의미
PROPTYPE_LONG
 서명된 긴 데이터
PROPTYPE_DATE
 날짜/시간(향후 사용을 위해 예약됨)
PROPTYPE_BINARY
 이진 데이터
PROPTYPE_STRING
 유니코드 문자열 데이터

[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, retval] pvarPropertyValue

요청된 속성 값을 받는 VARIANT 에 대한 포인터입니다.

VARIANT 사용을 마쳤으면 VariantClear 함수를 호출하여 해제합니다.

반환 값

C++

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

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

VB

반환 값은 요청된 속성 값을 받는 Variant 입니다.

요구 사항

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

추가 정보

CCertRequest

ICertRequest

ICertRequest2