Fungsi CertCreateCTLContext (wincrypt.h)

Artikel
03/13/2024

Fungsi CertCreateCTLContext membuat konteks daftar kepercayaan sertifikat (CTL) dari CTL yang dikodekan. Konteks yang dibuat tidak dipertahankan ke penyimpanan sertifikat. Fungsi ini membuat salinan CTL yang dikodekan dalam konteks yang dibuat.

Sintaks

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

Parameter

[in] dwMsgAndCertEncodingType

Menentukan jenis pengodean yang digunakan. Jenis pengodean sertifikat dan pesan harus ditentukan dengan menggabungkannya dengan operasi bitwise-OR seperti yang ditunjukkan dalam contoh berikut:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Jenis pengodean yang ditentukan saat ini adalah:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pbCtlEncoded

Pointer ke buffer yang berisi CTL yang dikodekan dari mana konteks akan dibuat.

[in] cbCtlEncoded

Ukuran, dalam byte, dari buffer pbCtlEncoded .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke CTL_CONTEXT baca-saja.

Jika fungsi gagal dan tidak dapat mendekode dan membuat CTL_CONTEXT, nilai yang dikembalikan adalah NULL. Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Tabel berikut ini memperlihatkan kemungkinan kode kesalahan.

Menampilkan kode	Deskripsi
E_INVALIDARG	Tipe pengodean sertifikat tidak valid. Hanya PKCS_7_ASN_ENCODING dan X509_ASN_ENCODING yang didukung.

Jika fungsi gagal, GetLastError dapat mengembalikan kesalahan pengodean/pendekodean Abstract Syntax Notation One (ASN.1). Untuk informasi tentang kesalahan ini, lihat Nilai Pengembalian Pengodean/Pendekodean ASN.1.

Keterangan

CTL_CONTEXT harus dibebaskan dengan memanggil CertFreeCTLContext. CertDuplicateCTLContext dapat dipanggil untuk membuat duplikat. CertSetCTLContextProperty dan CertGetCTLContextProperty dapat dipanggil untuk menyimpan dan membaca properti untuk CTL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll