Fungsi CertEnumCTLsInStore (wincrypt.h)

Artikel
08/27/2023

Fungsi CertEnumCTLsInStore mengambil konteks daftar kepercayaan sertifikat (CTL) pertama atau berikutnya di penyimpanan sertifikat. Digunakan dalam perulangan, fungsi ini dapat mengambil secara berurutan semua konteks CTL di penyimpanan sertifikat.

Sintaks

PCCTL_CONTEXT CertEnumCTLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCTL_CONTEXT pPrevCtlContext
);

Parameter

[in] hCertStore

Menangani penyimpanan sertifikat.

[in] pPrevCtlContext

Penunjuk ke struktur CTL_CONTEXT sebelumnya ditemukan. Harus NULL untuk mendapatkan CTL pertama di toko. CCL berturut-turut dijumlahkan dengan mengatur pPrevCtlContext ke pointer yang dikembalikan oleh panggilan sebelumnya. Fungsi ini membebaskan CTL_CONTEXT yang dirujuk oleh nilai non-NULL dari parameter ini. Enumerasi melewati CCL yang sebelumnya dihapus oleh CertDeleteCTLFromStore.

Mengembalikan nilai

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

Jika fungsi gagal dan CTL tidak ditemukan, nilai yang dikembalikan adalah NULL. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Beberapa kemungkinan kode kesalahan mengikuti.

Menampilkan kode	Deskripsi
CRYPT_E_NOT_FOUND	Baik tidak ada CCL di penyimpanan, atau fungsi mencapai akhir daftar penyimpanan.
E_INVALIDARG	Handel dalam parameter hCertStore tidak sama dengan yang dalam konteks CTL yang ditujukkan oleh parameter pPrevCtlContext .

Keterangan

Pointer yang dikembalikan dibebaskan saat diteruskan sebagai pPrevCtlContext pada panggilan berikutnya. Jika tidak, pointer harus dibebaskan secara eksplisit dengan memanggil CertFreeCTLContext. pPrevCtlContext yang bukan NULL selalu dibebaskan oleh fungsi ini (melalui panggilan ke CertFreeCTLContext), bahkan untuk kesalahan.

Duplikat dapat dibuat dengan memanggil CertDuplicateCTLContext.

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