Fungsi CertAddCRLLinkToStore (wincrypt.h)

Artikel
03/15/2023

Fungsi CertAddCRLLinkToStore menambahkan tautan di penyimpanan ke konteks daftar pencabutan sertifikat (CRL) di penyimpanan yang berbeda. Alih-alih membuat dan menambahkan duplikat CRL, fungsi ini menambahkan tautan ke konteks CRL asli.

Sintaks

BOOL CertAddCRLLinkToStore(
  [in]            HCERTSTORE    hCertStore,
  [in]            PCCRL_CONTEXT pCrlContext,
  [in]            DWORD         dwAddDisposition,
  [out, optional] PCCRL_CONTEXT *ppStoreContext
);

Parameter

[in] hCertStore

Menangani penyimpanan sertifikat tempat tautan akan ditambahkan.

[in] pCrlContext

Penunjuk ke struktur CRL_CONTEXT yang akan ditautkan.

[in] dwAddDisposition

Menentukan tindakan yang akan diambil jika CRL yang cocok atau tautan ke CRL yang cocok ada di penyimpanan. Nilai disposisi yang ditentukan saat ini dan penggunaannya adalah sebagai berikut.

Nilai	Makna
CERT_STORE_ADD_ALWAYS	Tidak melakukan pemeriksaan untuk CRL yang cocok atau tautan yang ada ke CRL yang cocok. Tautan baru selalu ditambahkan ke penyimpanan. Ini dapat menyebabkan duplikat di toko.
CERT_STORE_ADD_NEW	Jika CRL yang cocok atau tautan ke CRL yang cocok ada, operasi gagal. GetLastError mengembalikan kode CRYPT_E_EXISTS.
CERT_STORE_ADD_NEWER	Jika CRL yang cocok atau tautan ke CRL yang cocok ada, waktu ThisUpdate pada CRL dibandingkan. Jika CRL yang ada memiliki waktu ThisUpdate kurang dari waktu ThisUpdate pada CRL baru, tautan lama diganti sama seperti CERT_STORE_ADD_REPLACE_EXISTING. Jika CRL yang ada memiliki waktu ThisUpdate yang lebih besar dari atau sama dengan waktu ThisUpdate pada CRL yang akan ditambahkan, fungsi gagal dengan GetLastError mengembalikan kode CRYPT_E_EXISTS. Jika CRL yang cocok atau tautan ke CRL yang cocok tidak ditemukan di penyimpanan, tautan baru ditambahkan ke penyimpanan.
CERT_STORE_ADD_REPLACE_EXISTING	Jika tautan ke CRL yang cocok ada, tautan yang ada akan dihapus dan tautan baru dibuat dan ditambahkan ke penyimpanan. Jika CRL yang cocok atau tautan ke CRL yang cocok tidak ada, tautan baru ditambahkan.
CERT_STORE_ADD_USE_EXISTING	Jika CRL yang cocok atau tautan ke CRL yang cocok ada, tautan yang ada akan digunakan. Fungsi tidak gagal, tetapi tidak ada tautan baru yang ditambahkan. Jika CRL yang cocok atau tautan ke CRL tidak ada, tautan baru ditambahkan.

[out, optional] ppStoreContext

Penunjuk ke penunjuk salinan tautan yang dibuat. Parameter ppStoreContext dapat berupa NULL untuk menunjukkan bahwa salinan tautan tidak diperlukan. Jika salinan tautan dibuat, salinan tersebut harus dikosongkan menggunakan CertFreeCRLContext.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Beberapa kemungkinan kode kesalahan mengikuti.

Menampilkan kode	Deskripsi
CRYPT_E_EXISTS	Untuk dwAddDisposition CERT_STORE_ADD_NEW, CTL sudah ada di penyimpanan.
E_INVALIDARG	Nilai disposisi yang tidak valid ditentukan dalam parameter dwAddDisposition .

Keterangan

Karena tautan menyediakan akses ke konteks CRL asli, mengatur properti yang diperluas dalam perubahan konteks CRL tertaut yang memperluas properti di lokasi asli CRL dan di tautan lain ke CRL tersebut.

Tautan tidak dapat ditambahkan ke penyimpanan yang dibuka sebagai koleksi. Toko yang dibuka sebagai koleksi mencakup semua toko yang dibuka dengan CertOpenSystemStore atau CertOpenStore menggunakan CERT_STORE_PROV_SYSTEM atau CERT_STORE_PROV_COLLECTION. Untuk informasi selengkapnya, lihat CertAddStoreToCollection.

Jika tautan digunakan dan CertCloseStore dipanggil dengan CERT_CLOSE_STORE_FORCE_FLAG, penyimpanan yang menggunakan tautan harus ditutup sebelum penyimpanan yang berisi konteks asli dapat ditutup. Jika CERT_CLOSE_STORE_FORCE_FLAG tidak digunakan, kedua toko dapat ditutup dalam kedua pesanan.

Untuk menghapus tautan konteks CRL dari penyimpanan sertifikat, gunakan fungsi CertDeleteCRLFromStore .

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