PFN_CERT_DLL_OPEN_STORE_PROV_FUNC fungsi panggilan balik (wincrypt.h)
Fungsi CertDllOpenStoreProv diimplementasikan oleh penyedia toko dan digunakan untuk membuka toko. Fungsi ini dipanggil oleh fungsi CertOpenStore .
Sintaks
PFN_CERT_DLL_OPEN_STORE_PROV_FUNC PfnCertDllOpenStoreProvFunc;
BOOL PfnCertDllOpenStoreProvFunc(
[in] LPCSTR lpszStoreProvider,
[in] DWORD dwEncodingType,
[in] HCRYPTPROV_LEGACY hCryptProv,
[in] DWORD dwFlags,
[in] const void *pvPara,
[in] HCERTSTORE hCertStore,
[in, out] PCERT_STORE_PROV_INFO pStoreProvInfo
)
{...}
Parameter
[in] lpszStoreProvider
Penunjuk ke string ANSI yang dihentikan null yang berisi jenis penyedia penyimpanan.
Nilai berikut mewakili jenis penyimpanan yang telah ditentukan sebelumnya. Jenis penyedia toko menentukan konten parameter pvPara dan penggunaan dan arti dari kata tinggi parameter dwFlags . Penyedia penyimpanan tambahan dapat diinstal atau didaftarkan dengan menggunakan fungsi CryptInstallOIDFunctionAddress atau CryptRegisterOIDFunction . Untuk informasi selengkapnya tentang menambahkan penyedia toko, lihat Memperluas Fungsionalitas CertOpenStore.
| Pengidentifikasi penyedia | Deskripsi | Konten pvPara |
|---|---|---|
|
CERT_STORE_PROV_MEMORY
sz_CERT_STORE_PROV_MEMORY |
Membuat penyimpanan sertifikat dalam memori yang di-cache. Tidak ada sertifikat, daftar pencabutan sertifikat (CRL), atau daftar kepercayaan sertifikat (CCL) yang awalnya dimuat ke dalam penyimpanan. Biasanya digunakan untuk membuat penyimpanan sementara.
Setiap penambahan sertifikat, CRL, atau CCL atau perubahan properti sertifikat, CRL, atau CCL di penyimpanan memori tidak disimpan secara otomatis. Mereka dapat disimpan ke file atau ke BLOB memori dengan menggunakan CertSaveStore. |
Tidak digunakan. |
| CERT_STORE_PROV_FILE |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CCL yang dibaca dari file terbuka tertentu. Penyedia ini mengharapkan file hanya berisi penyimpanan berseri dan bukan pesan bertanda tangan PKCS #7 atau satu sertifikat yang dikodekan.
Penunjuk file harus diposisikan di awal informasi penyimpanan berseri. Setelah data di penyimpanan serial dimuat ke penyimpanan sertifikat, penunjuk file diposisikan di awal data apa pun yang dapat mengikuti data penyimpanan serial dalam file. Jika CERT_FILE_STORE_COMMIT_ENABLE diatur dalam dwFlags, handel file diduplikasi dan penyimpanan selalu diterapkan sebagai penyimpanan berseri. File tidak ditutup ketika penyimpanan ditutup. |
Penunjuk ke handel file yang dibuka dengan CreateFile. |
| CERT_STORE_PROV_FILENAME_A |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CCL dari file. Penyedia membuka file dan pertama-tama mencoba membaca file sebagai penyimpanan serial, lalu sebagai pesan yang ditandatangani PKCS #7, dan akhirnya sebagai satu sertifikat yang dikodekan.
Parameter dwEncodingType harus berisi jenis pengodean yang akan digunakan dengan pesan dan sertifikat. Jika file berisi sertifikat yang dikodekan X.509 , operasi terbuka gagal dengan GetLastError dan mengembalikan ERROR_ACCESS_DENIED. Jika bendera CERT_FILE_STORE_COMMIT_ENABLE diatur dalam dwFlags, nilai dwCreationDisposition yang diteruskan ke CreateFile adalah sebagai berikut:
Jika dwFlags menyertakan CERT_FILE_STORE_COMMIT_ENABLE, file diterapkan sebagai PKCS #7 atau penyimpanan berseri tergantung pada jenis file yang dibuka. Jika file kosong atau jika nama file memiliki ekstensi .p7c atau .spc, file diterapkan sebagai PKCS #7. Jika tidak, file diterapkan sebagai penyimpanan serial. |
Penunjuk ke string ANSI yang dihentikan null yang berisi nama file yang sudah ada dan belum dibuka. |
|
CERT_STORE_PROV_FILENAME
CERT_STORE_PROV_FILENAME_W sz_CERT_STORE_PROV_FILENAME sz_CERT_STORE_PROV_FILENAME_W |
Sama seperti CERT_STORE_PROV_FILENAME_A. | Penunjuk ke string Unicode yang dihentikan null yang berisi nama file yang sudah ada dan tidak dibuka. |
|
CERT_STORE_PROV_COLLECTION
sz_CERT_STORE_PROV_COLLECTION |
Membuka toko yang akan menjadi koleksi toko lain. Penyimpanan ditambahkan ke atau dihapus dari koleksi dengan menggunakan CertAddStoreToCollection dan CertRemoveStoreFromCollection. Saat penyimpanan ditambahkan ke koleksi, semua sertifikat, CRL, dan CCL di penyimpanan tersebut tersedia untuk pencarian atau enumerasi penyimpanan koleksi.
Kata tinggi dwFlags diatur ke nol. |
Harus NULL. |
| CERT_STORE_PROV_REG |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CTL dari subkuntang registri.
Penyedia ini membuka atau membuat sertifikat subkunci registri, CRL, dan CCL di bawah kunci yang diteruskan di pvPara. Kunci input tidak ditutup oleh penyedia. Sebelum kembali, penyedia membuka salinan kuncinya sendiri yang diteruskan di pvPara. Jika CERT_STORE_READONLY_FLAG diatur dalam kata rendah dwFlags, subkey registri dibuka dengan menggunakan RegOpenKey dengan KEY_READ_ACCESS. Jika tidak, subkunci registri dibuat dengan menggunakan RegCreateKey dengan KEY_ALL_ACCESS. Setiap perubahan pada konten penyimpanan yang dibuka segera dipertahankan ke registri. Namun, jika CERT_STORE_READONLY_FLAG diatur dalam kata rendah dwFlags, setiap upaya untuk menambahkan ke konten toko atau untuk mengubah properti konteks menghasilkan kesalahan dengan GetLastError mengembalikan kode E_ACCESSDENIED. |
Handel kunci registri terbuka. |
| CERT_STORE_PROV_SYSTEM_A |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CCL dari penyimpanan sistem yang ditentukan.
Penyimpanan sistem adalah penyimpanan koleksi logis yang terdiri dari satu atau beberapa penyimpanan fisik. Penyimpanan fisik yang terkait dengan penyimpanan sistem terdaftar dengan fungsi CertRegisterPhysicalStore . Setelah penyimpanan sistem dibuka, semua penyimpanan fisik yang terkait dengannya juga dibuka oleh panggilan ke CertOpenStore dan ditambahkan ke koleksi penyimpanan sistem dengan menggunakan fungsi CertAddStoreToCollection . Kata tinggi dwFlags menunjukkan lokasi penyimpanan sistem, biasanya diatur ke CERT_SYSTEM_STORE_CURRENT_USER. Untuk detail tentang lokasi registri, lihat dwFlags nanti di topik ini dan Lokasi Penyimpanan Sistem. Beberapa lokasi penyimpanan sistem dapat dibuka dari jarak jauh; untuk informasi selengkapnya, lihat Lokasi Penyimpanan Sistem. |
Penunjuk ke string ANSI yang dihentikan null yang berisi nama penyimpanan sistem, seperti "My" atau "Root". |
|
CERT_STORE_PROV_SYSTEM
CERT_STORE_PROV_SYSTEM_W sz_CERT_STORE_PROV_SYSTEM sz_CERT_STORE_PROV_SYSTEM_W |
Sama seperti CERT_STORE_PROV_SYSTEM_A. | Penunjuk ke string Unicode yang dihentikan null yang berisi nama penyimpanan sistem, seperti "My" atau "Root". |
| CERT_STORE_PROV_SYSTEM_REGISTRY_A |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CCL dari penyimpanan registri fisik. Penyimpanan fisik tidak dibuka sebagai penyimpanan koleksi. Enumerasi dan pencarian hanya melalui sertifikat, CRL, dan CTL di satu penyimpanan fisik.
Kata tinggi dwFlags menunjukkan lokasi penyimpanan sistem, biasanya diatur ke CERT_SYSTEM_STORE_CURRENT_USER. Untuk informasi selengkapnya, lihat dwFlags nanti dalam topik ini. Beberapa lokasi penyimpanan sistem dapat dibuka dari jarak jauh; untuk informasi selengkapnya, lihat Lokasi Penyimpanan Sistem. |
Penunjuk ke string ANSI yang dihentikan null yang berisi nama penyimpanan sistem, seperti "My" atau "Root". |
|
CERT_STORE_PROV_SYSTEM_REGISTRY
CERT_STORE_PROV_SYSTEM_REGISTRY_W sz_CERT_STORE_PROV_SYSTEM_REGISTRY sz_CERT_STORE_PROV_SYSTEM_REGISTRY_W |
Sama seperti CERT_STORE_PROV_SYSTEM_REGISTRY_A. | Penunjuk ke string Unicode yang dihentikan null yang berisi nama penyimpanan sistem, seperti "My" atau "Root". |
|
CERT_STORE_PROV_PHYSICAL
CERT_STORE_PROV_PHYSICAL_W sz_CERT_STORE_PROV_PHYSICAL sz_CERT_STORE_PROV_PHYSICAL_W |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CCL dari penyimpanan fisik tertentu yang merupakan anggota penyimpanan sistem logis.
Dua nama dipisahkan dengan garis miring terbelakang (\), misalnya "Root.LocalMachine". Di sini, "Root" adalah nama penyimpanan sistem dan ". LocalMachine" adalah nama toko fisik. Nama penyimpanan sistem dan fisik tidak boleh berisi garis miring terbelakang. Kata tinggi dwFlags menunjukkan lokasi penyimpanan sistem, biasanya CERT_SYSTEM_STORE_CURRENT_USER. Untuk informasi selengkapnya, lihat dwFlags nanti dalam topik ini. Beberapa lokasi toko fisik dapat dibuka dari jarak jauh. |
Penunjuk ke string Unicode yang dihentikan null yang berisi nama penyimpanan sistem dan nama fisik. |
| CERT_STORE_PROV_MSG | Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CCL dari pesan kriptografi yang ditentukan. Parameter dwEncodingType harus berisi jenis pengodean yang digunakan dengan pesan dan sertifikat. | Handel HCRYPTMSG dari pesan yang dikodekan, dikembalikan oleh panggilan ke CryptMsgOpenToDecode. |
|
CERT_STORE_PROV_PKCS7
sz_CERT_STORE_PROV_PKCS7 |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CTL dari pesan bertanda tangan PKCS #7 yang dikodekan. Parameter dwEncodingType harus menentukan jenis pengodean yang akan digunakan dengan pesan dan sertifikat. | Penunjuk ke struktur CRYPT_DATA_BLOB yang mewakili pesan yang dikodekan. |
|
CERT_STORE_PROV_SERIALIZED
sz_CERT_STORE_PROV_SERIALIZED |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CCL dari lokasi memori yang berisi penyimpanan serial. | Penunjuk ke struktur CRYPT_DATA_BLOB yang berisi BLOB memori berseri. |
|
CERT_STORE_PROV_LDAP
CERT_STORE_PROV_LDAP_W sz_CERT_STORE_PROV_LDAP sz_CERT_STORE_PROV_LDAP_W |
Menginisialisasi penyimpanan dengan sertifikat, CRL, dan CCL dari hasil kueri LDAP.
Untuk melakukan operasi tulis di penyimpanan, string kueri harus menentukan kueri BASE tanpa filter dan atribut tunggal. |
Jika parameter dwFlags berisi bendera CERT_LDAP_STORE_OPENED_FLAG , ini adalah alamat struktur CERT_LDAP_STORE_OPENED_PARA yang menentukan sesi LDAP yang ditetapkan untuk digunakan.
Jika tidak, ini adalah penunjuk ke string Unicode yang dihentikan null yang berisi string kueri LDAP. Untuk informasi selengkapnya tentang string kueri LDAP, lihat Dialek LDAP. |
|
CERT_STORE_PROV_SMART_CARD
CERT_STORE_PROV_SMART_CARD_W sz_CERT_STORE_PROV_SMART_CARD sz_CERT_STORE_PROV_SMART_CARD_W |
Saat ini tidak digunakan. |
[in] dwEncodingType
Menentukan jenis pengodean sertifikat dan jenis pengodean pesan. Pengodean hanya digunakan ketika parameter dwSaveAs dari fungsi CertSaveStore berisi CERT_STORE_SAVE_AS_PKCS7. Jika tidak, parameter dwEncodingType tidak digunakan.
Parameter ini hanya berlaku ketika jenis penyedia CERT_STORE_PROV_MSG, CERT_STORE_PROV_PKCS7, atau CERT_STORE_PROV_FILENAME ditentukan dalam parameter lpszStoreProvider . Untuk semua jenis penyedia lainnya, parameter ini tidak digunakan dan harus diatur ke nol.
Parameter ini bisa menjadi kombinasi dari satu atau beberapa nilai berikut.
| Nilai | Makna |
|---|---|
|
Menentukan pengodean pesan PKCS #7. |
|
Menentukan pengodean sertifikat X.509. |
[in] hCryptProv
Handel ke penyedia kriptografi. Parameter ini bisa NULL.
[in] dwFlags
Nilai-nilai ini terdiri dari nilai kata tinggi dan kata rendah yang digabungkan dengan menggunakan operasi bitwise-OR.
Bagian kata rendah dari dwFlags mengontrol berbagai karakteristik umum penyimpanan sertifikat yang dibuka. Bagian ini dapat digunakan dengan semua jenis penyedia penyimpanan. Bagian kata rendah dari dwFlags dapat menjadi salah satu nilai berikut.
| Nilai | Makna |
|---|---|
|
Buat penyimpanan baru jika tidak ada. Fungsi ini akan gagal jika penyimpanan sudah ada.
Jika tidak CERT_STORE_OPEN_EXISTING_FLAG atau CERT_STORE_CREATE_NEW_FLAG diatur, buka penyimpanan yang sudah ada atau buat dan buka toko jika belum ada. |
|
Tangguhkan penutupan penyedia toko sampai semua sertifikat, CRL, atau CCL yang diperoleh dari toko tidak lagi digunakan. Toko ini benar-benar ditutup ketika sertifikat terakhir, CRL, atau CTL yang diperoleh dari toko dibebaskan. Setiap perubahan yang dilakukan pada properti sertifikat, CRL, dan CCL ini, bahkan setelah panggilan ke fungsi ini, harus dipertahankan.
Jika bendera ini tidak diatur dan sertifikat, CRL, atau CCL yang diperoleh dari penyimpanan masih digunakan, setiap perubahan pada properti sertifikat, CRL, dan CCL tersebut tidak boleh dipertahankan. Jika fungsi ini dipanggil dengan CERT_CLOSE_STORE_FORCE_FLAG, CERT_STORE_DEFER_CLOSE_UNTIL_LAST_FREE_FLAG harus diabaikan. Ketika bendera ini diatur dan nilai HCRYPTPROVnon-NULL diteruskan, penyedia tersebut akan terus digunakan bahkan setelah panggilan ke fungsi ini. |
|
Penyimpanan dihapus alih-alih dibuka. Fungsi ini mengembalikan FALSE untuk keberhasilan dan kegagalan penghapusan. Untuk menunjukkan keberhasilan penghapusan, panggil SetLastError dengan nol. Untuk menunjukkan kegagalan penghapusan, panggil SetLastError dengan kode kesalahan yang sesuai. |
|
Biasanya, enumerasi semua sertifikat di penyimpanan akan mengabaikan sertifikat apa pun dengan kumpulan properti CERT_ARCHIVED_PROP_ID . Jika bendera ini diatur, enumerasi sertifikat di penyimpanan akan berisi semua sertifikat di penyimpanan, termasuk yang memiliki properti CERT_ARCHIVED_PROP_ID . |
|
Buka penyimpanan dengan sekumpulan maksimum izin yang diizinkan. Jika bendera ini ditentukan, penyimpanan registri pertama kali dibuka dengan akses tulis dan jika gagal, mereka dibuka kembali dengan akses baca-saja. |
|
Bendera ini tidak digunakan ketika parameter hCryptProv adalah NULL. Bendera ini hanya valid ketika handel CSP non-NULL diteruskan sebagai parameter hCryptProv . Mengatur bendera ini mencegah rilis otomatis CSP non-default saat penyimpanan sertifikat ditutup. |
|
Hanya buka penyimpanan yang ada. Jika penyimpanan tidak ada, fungsi gagal. |
|
Buka penyimpanan dalam mode baca-saja. Setiap upaya untuk mengubah isi penyimpanan akan mengakibatkan kesalahan. Ketika bendera ini diatur dan penyedia penyimpanan berbasis registri sedang digunakan, subkunjung registri dibuka dengan menggunakan RegOpenKey dengan KEY_READ_ACCESS. Jika tidak, subkunci registri dibuat dengan menggunakan RegCreateKey dengan KEY_ALL_ACCESS. |
|
Jika bendera ini didukung, penyedia mengatur properti CERT_STORE_LOCALIZED_NAME_PROP_ID toko. Nama yang dilokalkan dapat diambil dengan memanggil fungsi CertGetStoreProperty dengan dwPropID diatur ke CERT_STORE_LOCALIZED_NAME_PROP_ID. Bendera ini didukung untuk penyedia jenis CERT_STORE_PROV_FILENAME, CERT_STORE_PROV_SYSTEM, CERT_STORE_PROV_SYSTEM_REGISTRY, dan CERT_STORE_PROV_PHYSICAL_W. |
|
Saat membuka penyimpanan beberapa kali, Anda dapat mengatur bendera ini untuk memastikan penggunaan memori yang efisien dengan menggunakan kembali memori untuk bagian sertifikat, CRL, atau konteks CTL yang dikodekan di seluruh instans toko yang dibuka. |
|
Lists pengidentifikasi kunci ada dalam CurrentUser dan LocalMachine. Pengidentifikasi kunci ini memiliki properti seperti properti sertifikat. Jika CERT_STORE_UPDATE_KEYID_FLAG diatur, maka untuk setiap pengidentifikasi kunci di lokasi penyimpanan yang memiliki properti CERT_KEY_PROV_INFO_PROP_ID , properti tersebut secara otomatis diperbarui dari properti pengidentifikasi kunci CERT_KEY_PROV_INFO_PROP_ID atau CERT_KEY_IDENTIFIER_PROP_ID sertifikat yang terkait dengan pengidentifikasi kunci tersebut. |
|
Gunakan SE_BACKUP_NAME utas dan hak istimewa SE_RESTORE_NAME untuk membuka registri atau penyimpanan sistem berbasis file. Jika utas tidak memiliki hak istimewa ini, fungsi ini harus gagal dengan kesalahan akses ditolak. |
Jenis penyedia CERT_STORE_PROV_SYSTEM, CERT_STORE_PROV_SYSTEM_REGISTRY, dan CERT_STORE_PROV_PHYSICAL menggunakan kata-kata tinggi dwFlags berikut untuk menentukan lokasi registri penyimpanan sistem:
CERT_SYSTEM_STORE_CURRENT_SERVICE
CERT_SYSTEM_STORE_CURRENT_USER
CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY
CERT_SYSTEM_STORE_LOCAL_MACHINE
CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE
CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY
CERT_SYSTEM_STORE_SERVICES
CERT_SYSTEM_STORE_USERS
Secara default, lokasi penyimpanan sistem dibuka relatif terhadap kunci registri HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, atau HKEY_USERS yang telah ditentukan sebelumnya. Untuk informasi selengkapnya, lihat Lokasi Penyimpanan Sistem.
Bendera kata tinggi berikut mengambil alih perilaku default ini.
| Nilai | Makna |
|---|---|
|
Saat diatur, pvPara harus berisi penunjuk ke struktur CERT_SYSTEM_STORE_RELOCATE_PARA daripada string. Struktur menunjukkan nama penyimpanan dan lokasinya di registri. |
|
Secara default, ketika penyimpanan "Root" CurrentUser dibuka, akar SystemRegistry apa pun yang tidak ada di daftar akar yang dilindungi dihapus dari cache sebelum fungsi ini kembali. Ketika bendera ini diatur, default ini ditimpa dan semua akar di SystemRegistry dikembalikan dan tidak ada pemeriksaan daftar akar yang dilindungi yang dibuat. |
Penyedia CERT_STORE_PROV_REGISTRY menggunakan bendera kata tinggi berikut.
| Nilai | Makna |
|---|---|
|
Penyedia CERT_STORE_PROV_REG menyimpan sertifikat, CRL, dan CCL dalam satu subkunci penyimpanan serial alih-alih melakukan operasi penyimpanan default. Defaultnya adalah bahwa setiap sertifikat, CRL, atau CTL disimpan sebagai subkuntang registri terpisah di bawah subkuntang yang sesuai.
Bendera ini terutama digunakan untuk penyimpanan yang diunduh dari templat kebijakan grup (GPT), seperti penyimpanan CurrentUserGroupPolicy dan LocalMachineGroupPolicy. Saat CERT_REGISTRY_STORE_SERIALIZED_FLAG diatur, penambahan penyimpanan, penghapusan, atau perubahan properti tidak dipertahankan hingga ada panggilan ke CertCloseStore atau CertControlStore menggunakan CERT_STORE_CTRL_COMMIT. |
|
pvPara berisi handel ke kunci registri pada komputer jarak jauh. Untuk mengakses kunci registri pada komputer jarak jauh, izin keamanan pada komputer jarak jauh harus diatur untuk mengizinkan akses. Untuk informasi selengkapnya, lihat Keterangan. |
Jenis penyedia CERT_STORE_PROV_FILE dan CERT_STORE_PROV_FILENAME menggunakan bendera kata tinggi berikut.
| Nilai | Makna |
|---|---|
|
Mengatur bendera ini menerapkan penambahan apa pun ke penyimpanan atau perubahan apa pun yang dilakukan pada properti konteks di penyimpanan ke penyimpanan file baik ketika CertCloseStore dipanggil atau ketika CertControlStore dipanggil dengan CERT_STORE_CONTROL_COMMIT.
CertOpenStore gagal dengan E_INVALIDARG jika CERT_FILE_STORE_COMMIT_ENABLE dan CERT_STORE_READONLY_FLAG diatur dalam dwFlags. |
Jenis penyedia CERT_STORE_PROV_LDAP menggunakan bendera kata tinggi berikut.
| Nilai | Makna |
|---|---|
|
Untuk memberikan integritas yang diperlukan oleh beberapa aplikasi, tanda tangani semua lalu lintas LDAP secara digital ke dan dari server LDAP dengan menggunakan protokol autentikasi Kerberos. |
|
Gunakan bendera ini untuk menggunakan sesi LDAP yang ada. Ketika bendera ini ditentukan, parameter pvPara adalah alamat struktur CERT_LDAP_STORE_OPENED_PARA yang berisi informasi tentang sesi LDAP yang akan digunakan. |
|
Melakukan pencarian DNS khusus A-Record pada URL bernama dalam parameter pvPara . Ini mencegah kueri DNS palsu dihasilkan saat menyelesaikan nama host URL. Gunakan bendera ini saat meneruskan nama host dibandingkan dengan nama domain untuk parameter pvPara . |
|
Gunakan bendera ini dengan bendera CERT_LDAP_STORE_OPENED_FLAG untuk menyebabkan sesi LDAP tidak terikat saat penyimpanan ditutup. Sistem akan membatalkan ikatan sesi LDAP dengan menggunakan fungsi ldap_unbind saat penyimpanan ditutup. |
[in] pvPara
Nilai 32-bit yang dapat berisi informasi tambahan untuk fungsi ini. Isi parameter ini tergantung pada nilai lpszStoreProvider dan parameter lainnya.
[in] hCertStore
Handel penyimpanan dalam memori yang telah dibuka dan dapat digunakan untuk melakukan panggilan ke panggilan API terkait toko lainnya, seperti CertAddSerializedElementToStore.
[in, out] pStoreProvInfo
Penunjuk ke struktur CERT_STORE_PROV_INFO yang akan diperbarui. Struktur data telah di-nol, dan cbSize diatur sebelum panggilan.
Anggota cStoreProvFunc dari struktur CERT_STORE_PROV_INFO adalah jumlah fungsi panggilan balik yang diimplementasikan dan harus diatur terakhir. Setelah cStoreProvFunc diatur, semua panggilan penyimpanan berikutnya, seperti CertAddEncodedCertificateToStore, akan memanggil fungsi panggilan balik penyedia yang sesuai.
Mengembalikan nilai
TRUE jika berhasil; jika tidak, FALSE.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wincrypt.h |