다음을 통해 공유


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 현재 정의된 인코딩 형식은 다음과 같습니다.

  • 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 를 호출하여 중복을 만들 수 있습니다. CertSetCTLContextPropertyCertGetCTLContextProperty 를 호출하여 CTL에 대한 속성을 저장하고 읽을 수 있습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 wincrypt.h
라이브러리 Crypt32.lib
DLL Crypt32.dll

추가 정보

CTL_CONTEXT

CertCreateCRLContext

CertCreateCertificateContext

CertDuplicateCTLContext

CertFreeCTLContext

CertGetCTLContextProperty

CertSetCTLContextProperty

인증서 신뢰 목록 함수