Fungsi NCryptOpenStorageProvider (ncrypt.h)
Fungsi NCryptOpenStorageProvider memuat dan menginisialisasi penyedia penyimpanan kunci CNG.
Sintaks
SECURITY_STATUS NCryptOpenStorageProvider(
[out] NCRYPT_PROV_HANDLE *phProvider,
[in, optional] LPCWSTR pszProviderName,
[in] DWORD dwFlags
);
Parameter
[out] phProvider
Penunjuk ke variabel NCRYPT_PROV_HANDLE yang menerima handel penyedia. Setelah Anda selesai menggunakan handel ini, lepaskan dengan meneruskannya ke fungsi NCryptFreeObject .
[in, optional] pszProviderName
Penunjuk ke string Unicode yang dihentikan null yang mengidentifikasi penyedia penyimpanan utama untuk dimuat. Ini adalah alias terdaftar dari penyedia penyimpanan utama. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini NULL, penyedia penyimpanan kunci default akan dimuat. Nilai berikut mengidentifikasi penyedia penyimpanan kunci bawaan.
[in] dwFlags
Bendera yang mengubah perilaku fungsi. Tidak ada bendera yang didefinisikan untuk fungsi ini.
Mengembalikan nilai
Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.
Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Fungsi berhasil. |
|
Parameter dwFlags berisi satu atau beberapa bendera yang tidak didukung. |
|
Satu atau beberapa parameter tidak valid. |
|
Terjadi kegagalan alokasi memori. |
Keterangan
Jika kondisi kesalahan dikembalikan, penyedia akan dibongkar dari memori. Fungsi dalam penyedia tidak boleh dipanggil setelah kesalahan kegagalan dikembalikan.
Layanan tidak boleh memanggil fungsi ini dari Fungsi StartService-nya. Jika layanan memanggil fungsi ini dari fungsi StartService-nya, kebuntuan dapat terjadi, dan layanan mungkin berhenti merespons.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | ncrypt.h |
Pustaka | Ncrypt.lib |
DLL | Ncrypt.dll |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk