Fungsi NCryptEnumStorageProviders (ncrypt.h)

Artikel
03/13/2024

Fungsi NCryptEnumStorageProviders mendapatkan nama penyedia penyimpanan kunci terdaftar.

Sintaks

SECURITY_STATUS NCryptEnumStorageProviders(
  [out] DWORD              *pdwProviderCount,
  [out] NCryptProviderName **ppProviderList,
  [in]  DWORD              dwFlags
);

Parameter

[out] pdwProviderCount

Alamat DWORD untuk menerima jumlah elemen dalam array ppProviderList .

[out] ppProviderList

Alamat penunjuk struktur NCryptProviderName untuk menerima array nama penyedia penyimpanan kunci terdaftar. Variabel yang diarahkan oleh parameter pdwProviderCount menerima jumlah elemen dalam array ini.

Ketika memori ini tidak lagi diperlukan, bebaskan dengan meneruskan pointer ini ke fungsi NCryptFreeBuffer .

[in] dwFlags

Bendera yang mengubah perilaku fungsi. Ini bisa nol (0) atau nilai berikut.

Nilai	Makna
NCRYPT_SILENT_FLAG	Meminta agar penyedia layanan utama (KSP) tidak menampilkan antarmuka pengguna apa pun. Jika penyedia harus menampilkan UI untuk beroperasi, panggilan gagal dan KSP harus mengatur kode kesalahan NTE_SILENT_CONTEXT sebagai kesalahan terakhir.

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 nilai yang tidak valid.
NTE_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.
NTE_NO_MEMORY	Terjadi kegagalan alokasi memori.

Keterangan

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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	ncrypt.h
Pustaka	Ncrypt.lib
DLL	Ncrypt.dll

Lihat juga

NCryptFreeBuffer

Bagikan melalui