Fungsi NCryptIsAlgSupported (ncrypt.h)

Artikel
02/29/2024

Fungsi NCryptIsAlgSupported menentukan apakah penyedia penyimpanan kunci CNG mendukung algoritma kriptografi tertentu.

Sintaks

SECURITY_STATUS NCryptIsAlgSupported(
  [in] NCRYPT_PROV_HANDLE hProvider,
  [in] LPCWSTR            pszAlgId,
  [in] DWORD              dwFlags
);

Parameter

[in] hProvider

Handel penyedia penyimpanan utama. Handel ini diperoleh dengan fungsi NCryptOpenStorageProvider .

[in] pszAlgId

Penunjuk ke string Unicode yang dihentikan null yang mengidentifikasi algoritma kriptografi yang dimaksud. Ini bisa menjadi salah satu Pengidentifikasi Algoritma CNG standar atau pengidentifikasi untuk algoritma terdaftar lainnya.

[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	Penyedia mendukung algoritma yang ditentukan.
NTE_BAD_FLAGS	Parameter dwFlags berisi satu atau beberapa bendera yang tidak didukung.
NTE_INVALID_HANDLE	Handel yang ditentukan oleh parameter hProvider tidak valid.
NTE_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.
NTE_NOT_SUPPORTED	Penyedia tidak mendukung algoritma yang ditentukan.

Keterangan

Jika penyedia mendukung algoritma, fungsi ini mengembalikan ERROR_SUCCESS. Jika penyedia tidak mendukung algoritma, dan tidak ada kesalahan lain yang terjadi, fungsi ini mengembalikan NTE_NOT_SUPPORTED.

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