Bagikan melalui


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
NTE_NO_MEMORY
0x8009000EL
Memori tidak cukup tersedia untuk mengalokasikan buffer yang diperlukan.
NTE_INVALID_HANDLE
0x80090026L
Handel hSslProvider tidak valid.
NTE_INVALID_PARAMETER
0x80090027L
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
Sslprovider.h
DLL
Ncrypt.dll