CTL_CONTEXT 구조체(wincrypt.h)

아티클
08/27/2023

CTL_CONTEXT 구조체에는 CTL의 인코딩된 표현과 디코딩된 표현이 모두 포함됩니다. 또한 내부 콘텐츠로 CTL_INFO 포함하는 디코딩된 암호화 서명된 메시지에 대해 열린 HCRYPTMSG 핸들을 포함합니다.

CryptoAPI 하위 수준 메시지 함수를 사용하여 추가 서명자 정보를 추출할 수 있습니다.

CryptoAPI 함수에서 반환된 CTL_CONTEXTCertFreeCTLContext 함수를 호출하여 해제해야 합니다.

구문

typedef struct _CTL_CONTEXT {
  DWORD      dwMsgAndCertEncodingType;
  BYTE       *pbCtlEncoded;
  DWORD      cbCtlEncoded;
  PCTL_INFO  pCtlInfo;
  HCERTSTORE hCertStore;
  HCRYPTMSG  hCryptMsg;
  BYTE       *pbCtlContent;
  DWORD      cbCtlContent;
} CTL_CONTEXT, *PCTL_CONTEXT;

멤버

dwMsgAndCertEncodingType

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

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

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

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

pbCtlEncoded

인코딩된 CTL에 대한 포인터입니다.

cbCtlEncoded

인코딩된 CTL의 크기(바이트)입니다.

pCtlInfo

CTL_INFO 구조체에 대한 포인터는 CTL 정보를 포함합니다.

hCertStore

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

hCryptMsg

CTL_INFO 내부 콘텐츠로 포함하는 디코딩된 암호화 서명된 메시지에 대한HCRYPTMSG 핸들을 엽니다.

pbCtlContent

서명된 메시지의 인코딩된 내부 콘텐츠 입니다.

cbCtlContent

pbCtlContent의 개수(바이트)입니다.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	wincrypt.h