Fungsi NCryptEnumAlgorithms (ncrypt.h)

Artikel
03/15/2023

Fungsi NCryptEnumAlgorithms mendapatkan nama algoritma yang didukung oleh penyedia penyimpanan kunci yang ditentukan.

Sintaks

SECURITY_STATUS NCryptEnumAlgorithms(
  [in]  NCRYPT_PROV_HANDLE  hProvider,
  [in]  DWORD               dwAlgOperations,
  [out] DWORD               *pdwAlgCount,
  [out] NCryptAlgorithmName **ppAlgList,
  [in]  DWORD               dwFlags
);

Parameter

[in] hProvider

Handel penyedia penyimpanan utama untuk menghitung algoritma. Handel ini diperoleh dengan fungsi NCryptOpenStorageProvider .

[in] dwAlgOperations

Sekumpulan nilai yang menentukan kelas algoritma mana yang akan dijumlahkan. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai berikut. Jika dwAlgOperations adalah nol, semua algoritma dijumlahkan.

Nilai	Makna
NCRYPT_CIPHER_OPERATION 0x00000001	Menghitung algoritma cipher (enkripsi simetris).
NCRYPT_HASH_OPERATION 0x00000002	Menghitung algoritma hashing.
NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION 0x00000004	Menghitung algoritma enkripsi asimetris.
NCRYPT_SECRET_AGREEMENT_OPERATION 0x00000008	Menghitung algoritma perjanjian rahasia.
NCRYPT_SIGNATURE_OPERATION 0x00000010	Menghitung algoritma tanda tangan digital.

[out] pdwAlgCount

Alamat DWORD yang menerima jumlah elemen dalam array ppAlgList .

[out] ppAlgList

Alamat penunjuk struktur NCryptAlgorithmName yang menerima array nama algoritma terdaftar. Variabel yang diarahkan oleh parameter pdwAlgCount menerima jumlah elemen dalam array ini.

Ketika memori ini tidak lagi diperlukan, memori harus dibebaskan 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_HANDLE	Parameter hProvider 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 [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