ISignerCertificate::Initialize 메서드(certenroll.h)

Initialize 메서드는 서명 인증서에서 개체를 초기화합니다.

문법

HRESULT Initialize(
  [in] VARIANT_BOOL         MachineContext,
  [in] X509PrivateKeyVerify VerifyType,
  [in] EncodingType         Encoding,
  [in] BSTR                 strCertificate
);

매개 변수

[in] MachineContext

로컬 컴퓨터 인증서 저장소 컨텍스트 또는 사용자 컨텍스트를 검색하여 strCertificate 매개 변수로 식별된 인증서를 찾을지 여부를 나타내는 VARIANT_BOOL 변수입니다. 컴퓨터에 대한 VARIANT_TRUE 지정하고 사용자에 대한 VARIANT_FALSE 지정합니다.

[in] VerifyType

인증서 서명에 사용되는 프라이빗 키를 확인해야 하는지 여부와 확인이 자동이어야 하는지 아니면 사용자 입력을 허용하는지 여부를 지정하는 X509PrivateKeyVerify 열거형 값입니다.

[in] Encoding

DER(고유 인코딩 규칙) 인코딩 인증서 문자열에 적용되는 유니코드 인코딩 유형을 지정하는 EncodingType 열거형 값입니다.

[in] strCertificate

DER로 인코딩된 인증서를 포함하는 BSTR 변수입니다.

Windows 7 및 Windows Server 2008 R2부터 인코딩된 인증서 대신 인증서 지문 또는 일련 번호를 지정할 수 있습니다. 이렇게 하면 함수가 일치하는 인증서에 대한 적절한 로컬 저장소를 검색합니다. 다음 사항을 주의하세요.

• BSTR은 짝수의 16진수여야 합니다.
• 16진수 쌍 간의 공백은 무시됩니다.
• 인코딩 매개 변수는 XCN_CRYPT_STRING_HEXRAW 설정해야 합니다.
• MachineContext 매개 변수는 사용자 또는 컴퓨터 저장소 또는 둘 다 검색되는지 여부를 결정합니다.
• 프라이빗 키가 필요한 경우 개인 및 요청 저장소만 검색됩니다.
• 프라이빗 키가 필요하지 않은 경우 루트 및 중간 CA 저장소도 검색됩니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 제한되지는 않습니다. 일반적인 오류 코드 목록은 Common HRESULT 값을 참조하세요.

비고

Initialize 메서드:

• 인증서와 연결된 프라이빗 키가 있는지 확인합니다.
• IX509SignatureInformation 개체를 만들고 ISignerCertificate 개체에 할당합니다.
• 프라이빗 키에서 공개 키 알고리즘을 검색합니다.
• IX509SignatureInformation 개체에 공개 키 알고리즘을 할당합니다.

Initialize를 호출하기 전에 다음 속성을 설정합니다.

• ParentWindow
• 핀
• Silent
• UIContextMessage

요구 사항

참고하십시오

ISignerCertificate