CertAddEncodedCertificateToStore 함수(wincrypt.h)

CertAddEncodedCertificateToStore 함수는 인코딩된 인증서에서 인증서 컨텍스트를 만들어 인증서 저장소에 추가합니다. 만든 컨텍스트에는 확장 속성이 포함되지 않습니다.

또한 CertAddEncodedCertificateToStore 함수는 인증서를 저장소에 추가하기 전에 인코딩된 인증서의 복사본을 만듭니다.

구문

BOOL CertAddEncodedCertificateToStore(
  [in]            HCERTSTORE     hCertStore,
  [in]            DWORD          dwCertEncodingType,
  [in]            const BYTE     *pbCertEncoded,
  [in]            DWORD          cbCertEncoded,
  [in]            DWORD          dwAddDisposition,
  [out, optional] PCCERT_CONTEXT *ppCertContext
);

매개 변수

[in] hCertStore

인증서 저장소에 대한 핸들입니다.

[in] dwCertEncodingType

사용되는 인코딩 유형을 지정합니다. 다음 예제와 같이 비트 OR 작업과 결합하여 인증서 및 메시지 인코딩 형식을 모두 지정할 수 있습니다.

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING 현재 정의된 인코딩 형식은 다음과 같습니다.

• X509_ASN_ENCODING
• PKCS_7_ASN_ENCODING

[in] pbCertEncoded

인증서 저장소에 추가할 인코딩된 인증서를 포함하는 버퍼에 대한 포인터입니다.

[in] cbCertEncoded

pbCertEncoded 버퍼의 크기(바이트)입니다.

[in] dwAddDisposition

일치하는 인증서 또는 일치하는 인증서에 대한 링크가 저장소에 있는 경우 수행할 작업을 지정합니다. 현재 정의된 처리 값 및 해당 용도는 다음과 같습니다.

[out, optional] ppCertContext

디코딩된 인증서 컨텍스트에 대한 포인터에 대한 포인터입니다. 호출 애플리케이션에 새 인증서 또는 기존 인증서의 복사본이 필요하지 않음을 나타내는 NULL일 수 있는 선택적 매개 변수입니다. 복사본이 만들어지면 CertFreeCertificateContext를 사용하여 컨텍스트를 해제해야 합니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보는 GetLastError를 호출합니다. 몇 가지 가능한 오류 코드는 다음과 같습니다.

함수가 실패하면 GetLastError 는 추상 구문 표기법 1(ASN.1) 인코딩/디코딩 오류를 반환합니다. 이러한 오류에 대한 자세한 내용은 ASN.1 반환 값 인코딩/디코딩을 참조하세요.

요구 사항

추가 정보

CertAddCertificateContextToStore

CertFreeCertificateContext

인증서 함수