Fungsi NCryptOpenStorageProvider (ncrypt.h)

Artikel
03/08/2023

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.

Nilai	Makna
MS_KEY_STORAGE_PROVIDER L"Penyedia Penyimpanan Kunci Perangkat Lunak Microsoft"	Mengidentifikasi penyedia penyimpanan kunci perangkat lunak yang disediakan oleh Microsoft.
MS_SMART_CARD_KEY_STORAGE_PROVIDER L"Penyedia Penyimpanan Kunci Kartu Pintar Microsoft"	Mengidentifikasi penyedia penyimpanan kunci kartu pintar yang disediakan oleh Microsoft.
MS_PLATFORM_CRYPTO_PROVIDER L"Penyedia Kripto Platform Microsoft"	Mengidentifikasi penyedia penyimpanan kunci TPM yang disediakan oleh Microsoft.

[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
ERROR_SUCCESS	Fungsi berhasil.
NTE_BAD_FLAGS	Parameter dwFlags berisi satu atau beberapa bendera yang tidak didukung.
NTE_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.
NTE_NO_MEMORY	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

Bagikan melalui