Fungsi BCryptEnumProviders (bcrypt.h)

Fungsi BCryptEnumProviders mendapatkan semua penyedia CNG yang mendukung algoritma tertentu.

Sintaks

NTSTATUS BCryptEnumProviders(
  [in]  LPCWSTR              pszAlgId,
  [out] ULONG                *pImplCount,
  [out] BCRYPT_PROVIDER_NAME **ppImplList,
  [in]  ULONG                dwFlags
);

Parameter

[in] pszAlgId

Penunjuk ke string Unicode yang dihentikan null yang mengidentifikasi algoritma untuk mendapatkan penyedia. Ini bisa menjadi salah satu Pengidentifikasi Algoritma CNG yang telah ditentukan sebelumnya atau pengidentifikasi algoritma lainnya.

[out] pImplCount

Penunjuk ke variabel ULONG untuk menerima jumlah elemen dalam array ppImplList .

[out] ppImplList

Alamat array struktur BCRYPT_PROVIDER_NAME untuk menerima kumpulan penyedia yang mendukung algoritma yang ditentukan. Parameter pImplCount menerima jumlah elemen dalam array ini. Memori ini harus dikosongkan ketika tidak lagi diperlukan dengan meneruskan pointer ini ke fungsi BCryptFreeBuffer .

[in] dwFlags

Sekumpulan bendera yang memodifikasi perilaku fungsi ini. Saat ini tidak ada bendera yang ditentukan, jadi parameter ini harus nol.

Nilai kembali

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.
STATUS_NO_MEMORY	Terjadi kegagalan alokasi memori.

Keterangan

BCryptEnumProviders dapat dipanggil baik dari mode pengguna atau mode kernel. Pemanggil mode kernel harus dijalankan di PASSIVE_LEVELIRQL.

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	bcrypt.h
Pustaka	Bcrypt.lib
DLL	Bcrypt.dll

Lihat juga

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer