Fungsi CertEnumCRLsInStore (wincrypt.h)

Artikel
08/27/2023

Fungsi CertEnumCRLsInStore mengambil konteks daftar pencabutan sertifikat (CRL) pertama atau berikutnya di penyimpanan sertifikat. Digunakan dalam perulangan, fungsi ini dapat mengambil secara berurutan semua konteks CRL di penyimpanan sertifikat.

Sintaks

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

Parameter

[in] hCertStore

Menangani penyimpanan sertifikat.

[in] pPrevCrlContext

Penunjuk ke struktur CRL_CONTEXT sebelumnya ditemukan. Parameter pPrevCrlContext harus NULL untuk mendapatkan CRL pertama di penyimpanan. CRL berturut-turut dijumlahkan dengan mengatur pPrevCrlContext ke pointer yang dikembalikan oleh panggilan sebelumnya ke fungsi. Fungsi ini membebaskan CRL_CONTEXT yang dirujuk oleh nilai non-NULL dari parameter ini. Enumerasi melewati CRL apa pun yang sebelumnya dihapus oleh CertDeleteCRLFromStore.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke CRL_CONTEXT berikutnya di penyimpanan.

NULL dikembalikan jika fungsi gagal. Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Beberapa kemungkinan kode kesalahan mengikuti.

Menampilkan kode	Deskripsi
E_INVALIDARG	Handel dalam parameter hCertStore tidak sama dengan yang dalam konteks sertifikat yang ditujukan oleh pPrevCrlContext.
CRYPT_E_NOT_FOUND	Tidak ada CRL yang ditemukan. Ini terjadi jika penyimpanan kosong atau akhir daftar toko tercapai.

Keterangan

Pointer yang dikembalikan dibebaskan ketika diteruskan sebagai pPrevCrlContext pada panggilan berikutnya ke fungsi. Jika tidak, pointer harus secara eksplisit dibebaskan dengan memanggil CertFreeCRLContext. pPrevCrlContext yang bukan NULL selalu dibebaskan ketika diteruskan ke fungsi ini melalui panggilan ke CertFreeCRLContext, bahkan jika fungsi itu sendiri mengembalikan kesalahan.

Duplikat konteks CRL yang dikembalikan oleh fungsi ini dapat dibuat dengan memanggil CertDuplicateCRLContext.

Persyaratan


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