Fungsi CertCreateCRLContext (wincrypt.h)

Artikel
03/03/2024

Fungsi CertCreateCRLContext membuat konteks daftar pencabutan sertifikat (CRL) dari CRL yang dikodekan. Konteks yang dibuat tidak dipertahankan ke penyimpanan sertifikat. Ini membuat salinan CRL yang dikodekan dalam konteks yang dibuat.

Sintaks

PCCRL_CONTEXT CertCreateCRLContext(
  [in] DWORD      dwCertEncodingType,
  [in] const BYTE *pbCrlEncoded,
  [in] DWORD      cbCrlEncoded
);

Parameter

[in] dwCertEncodingType

Menentukan 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 ditentukan saat ini adalah:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pbCrlEncoded

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

[in] cbCrlEncoded

Ukuran, dalam byte, dari buffer pbCrlEncoded .

Mengembalikan nilai

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

Jika fungsi gagal dan tidak dapat mendekode dan membuat CRL_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. Saat ini, hanya jenis pengodean 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

CRL_CONTEXT harus dibebaskan dengan memanggil CertFreeCRLContext. CertDuplicateCRLContext dapat dipanggil untuk membuat duplikat. CertSetCRLContextProperty dan CertGetCRLContextProperty dapat dipanggil untuk menyimpan dan membaca properti untuk CRL.

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