Fungsi SslOpenPrivateKey
Fungsi SslOpenPrivateKey membuka handel ke kunci privat.
Sintaks
SECURITY_STATUS WINAPI SslOpenPrivateKey(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_Out_ NCRYPT_KEY_HANDLE *phPrivateKey,
_In_ PCCERT_CONTEXT pCertContext,
_In_ DWORD dwFlags
);
Parameter
-
hSslProvider [in]
-
Handel ke instans penyedia protokol Secure Sockets Layer protocol (SSL).
-
phPrivateKey [out]
-
Alamat buffer untuk menulis handel ke kunci privat.
Setelah selesai menggunakan kunci, Anda harus membebaskan phPrivateKey dengan memanggil fungsi SslFreeObject .
-
pCertContext [in]
-
Alamat sertifikat untuk mendapatkan kunci privat.
-
dwFlags [in]
-
Parameter ini dicadangkan untuk digunakan di masa mendatang.
Mengembalikan nilai
Jika fungsi berhasil, fungsi akan mengembalikan nol.
Jika fungsi gagal, fungsi mengembalikan nilai kesalahan bukan nol.
Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Memori tidak cukup tersedia untuk mengalokasikan buffer yang diperlukan. |
|
Handel hSslProvider tidak valid. |
|
Parameter phPrivateKey atau pCertContext adalah NULL. |
Keterangan
Kunci privat yang diperoleh adalah bagian dari pasangan kunci publik/privat dalam sertifikat. Fungsi ini hanya mengekstrak kunci privat dari sertifikat yang ditentukan oleh parameter pCertContext .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2008 [hanya aplikasi desktop] |
Header |
|
DLL |
|