다음을 통해 공유

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

  • 아티클

GetFullResponseProperty 메서드는 서버에서 반환된 캐시된 응답 데이터를 검색합니다.

구문

HRESULT GetFullResponseProperty(
  [in]  LONG    PropId,
  [in]  LONG    PropIndex,
  [in]  LONG    PropType,
  [in]  LONG    Flags,
  [out] VARIANT *pvarPropertyValue
);

매개 변수

[in] PropId

검색할 데이터입니다. 속성이 인덱싱된 경우 PropIndex 를 사용하여 인덱스를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
FR_PROP_NONE
0
 데이터가 없습니다.
FR_PROP_FULLRESPONSE
1
 캐시된 모든 데이터가 검색됩니다(이진 데이터).
FR_PROP_STATUSINFOCOUNT
2
 캐시 데이터의 응답 수(긴 인덱싱된 속성)입니다.
FR_PROP_BODYPARTSTRING
3
 계층 데이터(문자열, 인덱싱된 속성).
FR_PROP_STATUS
4
 요청 상태 값(long, indexed 속성)입니다.
FR_PROP_STATUSSTRING
5
 요청 상태 문자열(문자열, 인덱싱된 속성)입니다.
FR_PROP_OTHERINFOCHOICE
6
 다른 정보(긴 인덱싱된 속성)에 대한 선택입니다. 다음 값 중 하나일 수 있습니다.
  • CMC_OTHER_INFO_NO_CHOICE
  • CMC_OTHER_INFO_FAIL_CHOICE
  • CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO
7
 요청 실패 정보(긴 인덱싱된 속성)입니다.
FR_PROP_PENDINFOTOKEN
8
 요청 보류 중인 토큰(이진, 인덱싱된 속성)입니다.
FR_PROP_PENDINFOTIME
9
 요청 보류 날짜(DATE, 인덱싱된 속성)입니다.
FR_PROP_ISSUEDCERTIFICATEHASH
10
 발급된 인증서의 해시(이진, 인덱싱된 속성)가 검색됩니다.
FR_PROP_ISSUEDCERTIFICATE
11
 발급된 인증서(이진, 인덱싱된 속성)가 검색됩니다.
FR_PROP_ISSUEDCERTIFICATECHAIN
12
 발급된 인증서(이진, 인덱싱된 속성)입니다.
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
13
 발급된 인증서 체인(이진, 인덱싱된 속성)입니다.
FR_PROP_ENCRYPTEDKEYHASH
14
 암호화된 키 해시(이진, 인덱싱된 속성)입니다.
FR_PROP_FULLRESPONSENOPKCS7
15
 PKCS #7(이진)을 제외하고 캐시된 모든 데이터가 검색됩니다.
FR_PROP_CAEXCHANGECERTIFICATEHASH
16
 CA 교환 인증서 해시입니다.
FR_PROP_CAEXCHANGECERTIFICATE
17
 CA 교환 인증서입니다.
FR_PROP_CAEXCHANGECERTIFICATECHAIN
18
 CA 교환 인증서 체인입니다.
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN
19
 CA 교환 인증서 CLR 체인입니다.
FR_PROP_ATTESTATIONCHALLENGE
20
 주요 증명 챌린지 응답
FR_PROP_ATTESTATIONPROVIDERNAME
21
 키 증명에 대한 키 스토리지 공급자의 이름입니다.

[in] PropIndex

PropId가 인덱싱된 속성인 경우 0부터 시작하는 인덱스입니다. PropId가 인덱싱된 속성이 아니면 PropIndex는 0이어야 합니다.

[in] PropType

pvarPropertyValue에서 반환되는 데이터 형식입니다. 여기에 있는 속성 형식은 PropId 매개 변수로 지정된 데이터 형식과 일치해야 합니다.

이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
PROPTYPE_LONG
1
 서명된 긴 데이터입니다.
PROPTYPE_DATE
2
 날짜 데이터(날짜 및 시간 포함)
PROPTYPE_BINARY
3
 이진 데이터.
PROPTYPE_STRING
4
 문자열 데이터입니다.

[in] Flags

pvarPropertyValue에서 반환된 데이터의 형식입니다. 여기에 설정된 플래그는 PropId 매개 변수로 지정된 데이터 형식과 일치해야 합니다.

자세한 내용은 설명 부분을 참조하세요. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
CR_OUT_BASE64HEADER
0
 시작/끝 헤더가 있는 BASE64 형식입니다.
CR_OUT_BASE64
1
 시작/끝 헤더가 없는 BASE64 형식입니다.
CR_OUT_BINARY
2
 이진 형식입니다.

[out] pvarPropertyValue

반환된 데이터입니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환하고 pvarPropertyValue 에는 반환된 데이터가 포함됩니다.

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

VB

반환 값은 반환된 데이터를 포함하는 Variant 입니다.

설명

다음 PropId 값은 이진 데이터를 반환합니다. 즉, Flags 매개 변수가 CR_OUT_BINARY.

  • FR_PROP_FULLRESPONSE
  • FR_PROP_ISSUEDCERTIFICATEHASH
  • FR_PROP_ISSUEDCERTIFICATE
  • FR_PROP_ISSUEDCERTIFICATECHAIN
  • FR_PROP_ISSUEDCERTIFICATECRLCHAIN
  • FR_PROP_ENCRYPTEDKYEHASH
  • FR_PROP_FULLRESPONSENOPKCS7
이 메서드는 ICertRequest3::Submit 또는 ICertRequest3::RetrievePending 메서드가 호출된 후에 호출됩니다. 이러한 메서드는 GetFullResponseProperty에서 반환되는 캐시된 데이터를 채웁니다.

ICertRequest3::GetFullResponseProperty 메서드가 해당 데이터를 반환한 후 다음 메서드를 호출할 수 있습니다.

요구 사항

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