Fungsi NCryptEnumKeys (ncrypt.h)

Fungsi NCryptEnumKeys mendapatkan nama kunci yang disimpan oleh penyedia.

Sintaks

SECURITY_STATUS NCryptEnumKeys(
  [in]           NCRYPT_PROV_HANDLE hProvider,
  [in, optional] LPCWSTR            pszScope,
  [out]          NCryptKeyName      **ppKeyName,
  [in, out]      PVOID              *ppEnumState,
  [in]           DWORD              dwFlags
);

Parameter

[in] hProvider

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

[in, optional] pszScope

Parameter ini saat ini tidak digunakan dan harus NULL.

[out] ppKeyName

Alamat penunjuk ke struktur NCryptKeyName yang menerima nama kunci yang diambil. Ketika aplikasi telah selesai menggunakan memori ini, bebaskan dengan memanggil fungsi NCryptFreeBuffer .

[in, out] ppEnumState

Alamat penunjuk VOID yang menerima informasi status enumerasi yang digunakan dalam panggilan berikutnya ke fungsi ini. Informasi ini hanya memiliki arti pada penyedia penyimpanan utama dan buram untuk pemanggil. Penyedia penyimpanan utama menggunakan informasi ini untuk menentukan item mana yang berikutnya dalam enumerasi. Jika variabel yang ditujukkan oleh parameter ini berisi NULL, enumerasi dimulai dari awal.

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

[in] dwFlags

Bendera yang mengubah perilaku fungsi. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

Nilai kembali

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

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

Keterangan

Fungsi ini hanya mengambil satu item setiap kali dipanggil. Status enumerasi disimpan dalam variabel yang diarahkan oleh parameter ppEnumState , sehingga ini harus dipertahankan di antara panggilan ke fungsi ini. Ketika kunci terakhir yang disimpan oleh penyedia telah diambil, fungsi ini akan mengembalikan NTE_NO_MORE_ITEMS lain kali dipanggil. Untuk memulai enumerasi, atur variabel yang diarahkan ke oleh parameter ppEnumState ke NULL, kosongkan memori yang diarahkan oleh parameter ppKeyName , jika bukan NULL, dan panggil fungsi ini lagi.

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