IX509AttributeRenewalCertificate::InitializeDecode 메서드(certenroll.h)
InitializeDecode 메서드는 갱신할 인증서가 포함된 DISTINGUISHED ENCODING RULES(DER) 인코딩된 바이트 배열에서 개체를 초기화합니다. 바이트 배열은 유니코드로 인코딩된 문자열로 표시됩니다.
구문
HRESULT InitializeDecode(
[in] EncodingType Encoding,
[in] BSTR strEncodedData
);
매개 변수
[in] Encoding
입력 문자열에 적용된 유니코드 인코딩의 형식을 지정하는 EncodingType 열거형 값입니다.
[in] strEncodedData
DER로 인코딩된 인증서를 포함하는 BSTR 변수입니다.
Windows 7 및 Windows Server 2008 R2부터는 인코딩된 인증서 대신 인증서 지문 또는 일련 번호를 지정할 수 있습니다. 이렇게 하면 함수가 일치하는 인증서에 대한 적절한 로컬 저장소를 검색합니다. 다음 사항을 주의하세요.
- BSTR은 짝수의 16진수여야 합니다.
- 16진수 쌍 간의 공백은 무시됩니다.
- 인코딩 매개 변수는 XCN_CRYPT_STRING_HEXRAW 설정해야 합니다.
- 프라이빗 키가 필요한 경우 개인 및 요청 저장소만 검색됩니다.
- 프라이빗 키가 필요하지 않은 경우 루트 및 중간 CA 저장소도 검색됩니다.
반환 값
함수가 성공하면 함수는 S_OK 반환합니다.
함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.
설명
이 특성의 OID( 개체 식별자 )는 XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1)입니다. 자세한 내용은 CERTENROLL_OBJECTID 참조하세요.
특성 값을 포함하는 DER로 인코딩된 ASN.1( 추상 구문 표기법 One ) 개체가 있는 경우 이 메서드를 사용할 수 있습니다. 유니코드로 인코딩된 문자열에 DER로 인코딩된 개체를 제공해야 합니다. 자세한 내용은 IBinaryConverter 인터페이스를 참조하세요.
IX509AttributeRenewalCertificate 개체를 사용하려면 먼저 InitializeEncode 또는 InitializeDecode를 호출해야 합니다. 두 메서드는 서로를 보완합니다. InitializeEncode 메서드를 사용하면 원시 데이터에서 인코딩된 ASN.1 구조를 생성할 수 있으며 InitializeDecode 메서드를 사용하면 인코딩된 ASN.1 구조체에서 원시 데이터를 초기화할 수 있습니다. RenewalCertificate 속성을 호출하여 원시 데이터를 검색할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | certenroll.h |
| DLL | CertEnroll.dll |