struktur CTL_CONTEXT (wincrypt.h)

Artikel
03/15/2023

Struktur CTL_CONTEXT berisi representasi CTL yang dikodekan dan didekodekan. Ini juga berisi handel HCRYPTMSG yang dibuka ke pesan yang didekodekan dan ditandatangani secara kriptografis yang berisi CTL_INFO sebagai konten dalamnya.

Fungsi pesan tingkat rendah CryptoAPI dapat digunakan untuk mengekstrak informasi penanda tangan tambahan.

CTL_CONTEXT yang dikembalikan oleh fungsi CryptoAPI apa pun harus dibebaskan dengan memanggil fungsi CertFreeCTLContext.

Sintaks

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;

Anggota

dwMsgAndCertEncodingType

Jenis pengodean yang digunakan. Selalu dapat diterima untuk menentukan jenis pengodean sertifikat dan pesan dengan menggabungkannya dengan operasi bitwise-OR seperti yang ditunjukkan dalam contoh berikut:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Jenis pengodean yang saat ini ditentukan adalah:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

pbCtlEncoded

Penunjuk ke CTL yang dikodekan.

cbCtlEncoded

Ukuran, dalam byte, dari CTL yang dikodekan.

pCtlInfo

Penunjuk ke struktur CTL_INFO berisi informasi CTL.

hCertStore

Handel ke penyimpanan sertifikat.

hCryptMsg

Buka handel HCRYPTMSG ke pesan yang didekodekan dan ditandatangani kriptografi yang berisi CTL_INFO sebagai konten dalamnya.

pbCtlContent

Konten dalam yang dikodekan dari pesan yang ditandatangani.

cbCtlContent

Hitung, dalam byte, dari pbCtlContent.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	wincrypt.h