Fungsi CryptGetUserKey (wincrypt.h)
Sintaks
BOOL CryptGetUserKey(
[in] HCRYPTPROV hProv,
[in] DWORD dwKeySpec,
[out] HCRYPTKEY *phUserKey
);
Parameter
[in] hProv
Handel HCRYPTPROV dari penyedia layanan kriptografi (CSP) yang dibuat oleh panggilan ke CryptAcquireContext.
[in] dwKeySpec
Mengidentifikasi kunci privat yang akan digunakan dari kontainer kunci. Ini bisa AT_KEYEXCHANGE atau AT_SIGNATURE.
Selain itu, beberapa penyedia mengizinkan akses ke kunci khusus pengguna lainnya melalui fungsi ini. Untuk detailnya, lihat dokumentasi tentang penyedia tertentu.
[out] phUserKey
Penunjuk ke handel HCRYPTKEY dari kunci yang diambil. Setelah Anda selesai menggunakan kunci, hapus handel dengan memanggil fungsi CryptDestroyKey .
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol (TRUE).
Jika fungsi gagal, nilai yang dikembalikan adalah nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError.
Kode kesalahan yang diawali oleh "NTE" dihasilkan oleh CSP tertentu yang digunakan. Beberapa kemungkinan kode kesalahan mengikuti.
Menampilkan kode | Deskripsi |
---|---|
|
Salah satu parameter menentukan handel yang tidak valid. |
|
Salah satu parameter berisi nilai yang tidak valid. Ini paling sering merupakan pointer yang tidak valid. |
|
Parameter dwKeySpec berisi nilai yang tidak valid. |
|
Parameter hProv tidak berisi handel konteks yang valid. |
|
Kunci yang diminta oleh parameter dwKeySpec tidak ada. |
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | wincrypt.h |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |