CertCreateCTLContext 함수(wincrypt.h)

CertCreateCTLContext 함수는 인코딩된 CTL에서 CTL(인증서 신뢰 목록) 컨텍스트를 만듭니다. 만든 컨텍스트는 인증서 저장소에 유지되지 않습니다. 함수는 생성된 컨텍스트 내에서 인코딩된 CTL의 복사본을 만듭니다.

구문

PCCTL_CONTEXT CertCreateCTLContext(
  [in] DWORD      dwMsgAndCertEncodingType,
  [in] const BYTE *pbCtlEncoded,
  [in] DWORD      cbCtlEncoded
);

[in] dwMsgAndCertEncodingType

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

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

[in] pbCtlEncoded

컨텍스트를 만들 인코딩된 CTL을 포함하는 버퍼에 대한 포인터입니다.

[in] cbCtlEncoded

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

함수가 성공하면 반환 값은 읽기 전용 CTL_CONTEXT 대한 포인터입니다.

함수가 실패하고 디코딩하고 CTL_CONTEXT 만들 수 없는 경우 반환 값은 NULL입니다. 확장된 오류 정보는 GetLastError를 호출합니다. 다음 표에는 가능한 오류 코드가 표시됩니다.

반환 코드	설명
E_INVALIDARG	인증서 인코딩 유형이 잘못되었습니다. PKCS_7_ASN_ENCODING 및 X509_ASN_ENCODING만 지원됩니다.

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

certFreeCTLContext를 호출하여 CTL_CONTEXT 해제해야 합니다. CertDuplicateCTLContext 를 호출하여 중복을 만들 수 있습니다. CertSetCTLContextProperty 및 CertGetCTLContextProperty 를 호출하여 CTL에 대한 속성을 저장하고 읽을 수 있습니다.