Bagikan melalui

Fungsi SslOpenProvider

  • Artikel

Fungsi SslOpenProvider membuka handel ke penyedia protokol Secure Sockets Layer protocol (SSL) yang ditentukan.

Sintaks

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

Parameter

phSslProvider [out]

Alamat NCRYPT_PROV_HANDLE untuk menulis handel penyedia.

Setelah selesai menggunakan handel, Anda harus membebaskannya dengan memanggil fungsi SslFreeObject .

pszProviderName [in]

Penunjuk ke string Unicode yang berisi nama penyedia. Jika nilai parameter ini adalah NULL, handel ke MS_SCHANNEL_PROVIDER dikembalikan.

dwFlags [in]

Parameter ini dicadangkan untuk digunakan di masa mendatang, dan harus diatur ke nol.

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_INVALID_HANDLE
0x80090026L
 Salah satu handel yang disediakan tidak valid.
NTE_INVALID_PARAMETER
0x80090027L
 Parameter phSslProvider atau ppProviderList adalah NULL.
STATUS_NO_MEMORY
0xC0000017L
 Memori tidak cukup tersedia untuk mengalokasikan buffer yang diperlukan.

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