ICertProperties::InitializeFromCertificate 메서드(certenroll.h)
InitializeFromCertificate 메서드는 인증서에 포함된 속성에서 컬렉션을 초기화합니다.
구문
HRESULT InitializeFromCertificate(
[in] VARIANT_BOOL MachineContext,
[in] EncodingType Encoding,
[in] BSTR strCertificate
);
매개 변수
[in] MachineContext
인증서 저장소 컨텍스트를 식별하는 VARIANT_BOOL 변수입니다. 컴퓨터에 대한 VARIANT_TRUE 지정하고 사용자에 대한 VARIANT_FALSE 지정합니다.
[in] Encoding
strCertificate 매개 변수에 포함된 인증서에 적용되는 유니코드 인코딩 유형을 지정하는 EncodingType 열거형 값입니다.
[in] strCertificate
DER로 인코딩된 인증서를 포함하는 BSTR 변수입니다.
Windows 7 및 Windows Server 2008 R2부터는 인코딩된 인증서 대신 인증서 지문 또는 일련 번호를 지정할 수 있습니다. 이렇게 하면 함수가 일치하는 인증서에 대한 적절한 로컬 저장소를 검색합니다. 다음 사항을 주의하세요.
- BSTR은 짝수의 16진수여야 합니다.
- 16진수 쌍 간의 공백은 무시됩니다.
- 인코딩 매개 변수는 XCN_CRYPT_STRING_HEXRAW 설정해야 합니다.
- MachineContext 매개 변수는 사용자 또는 컴퓨터 저장소 또는 둘 다를 검색할지 여부를 결정합니다.
- 프라이빗 키가 필요한 경우 개인 및 요청 저장소만 검색됩니다.
- 프라이빗 키가 필요하지 않은 경우 루트 및 중간 CA 저장소도 검색됩니다.
반환 값
함수가 성공하면 함수는 S_OK 반환합니다.
함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.
반환 코드/값 | 설명 |
---|---|
|
인증서를 찾을 수 없습니다. |
|
인증서를 찾았지만 프라이빗 키를 로드할 수 없습니다. |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | certenroll.h |
DLL | CertEnroll.dll |