Bagikan melalui


Fungsi SslGetProviderProperty

Fungsi SslGetProviderProperty mengambil nilai properti penyedia tertentu.

Sintaks

SECURITY_STATUS WINAPI SslGetProviderProperty(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _In_    LPCWSTR            pszProperty,
  _Out_   PBYTE              ppbOutput,
  _Out_   DWORD              *pcbOutput,
  _Inout_ PVOID              *ppEnumState,
  _In_    DWORD              dwFlags
);

Parameter

hSslProvider [in]

Handel penyedia protokol Secure Sockets Layer (SSL) untuk mengambil properti .

pszProperty [in]

Penunjuk ke string Unicode yang dihentikan null yang berisi nama properti yang akan diambil.

ppbOutput [out]

Alamat buffer yang menerima nilai properti.

Pemanggil fungsi harus membebaskan buffer ini dengan memanggil fungsi SslFreeBuffer .

pcbOutput [out]

Ukuran, dalam byte, dari buffer pbOutput .

ppEnumState [masuk, keluar]

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

Pemanggil fungsi harus membebaskan memori ini dengan memanggil fungsi SslFreeBuffer .

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
Salah satu parameter yang disediakan tidak valid.

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