Fungsi EapHostPeerQueryUserBlobFromCredentialInputFields (eaphostpeerconfigapis.h)

Artikel
03/14/2023

Fungsi EapHostPeerQueryUserBlobFromCredentialInputFields mendapatkan BLOB kredensial yang dapat digunakan untuk memulai autentikasi dari input pengguna yang diterima dari UI Akses Menyeluruh (SSO).

Sintaks

DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      const BYTE                         *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [out]     EAP_ERROR                          **ppEapError
);

Parameter

[in] hUserImpersonationToken

Handel ke token peniruan identitas pengguna untuk digunakan dalam sesi ini.

[in] eapMethodType

Struktur EAP_METHOD_TYPE yang menentukan jenis autentikasi EAP yang akan digunakan untuk sesi ini.

[in] dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

[in] dwEapConnDataSize

Ukuran, dalam byte, dari buffer data koneksi yang disediakan dalam pConnectionData.

[in] pbEapConnData

Data koneksi yang digunakan untuk metode EAP.

[in] pEapConfigInputFieldArray

Penunjuk ke struktur EAP_CONFIG_INPUT_FIELD_ARRAY berisi data bidang input UI. Pemanggil harus membebaskan pointer dalam menggunakan fungsi EapHostPeerFreeMemory, dimulai dari pointer terdahulu.

[in, out] pdwUserBlobSize

Penunjuk ke DWORD yang menentukan ukuran, dalam byte, dari buffer yang ditujukkan oleh ppbUserBlob. Jika nilai ini tidak diatur ke nol, maka penunjuk ke buffer ukuran yang ditentukan dalam parameter ini harus disediakan ke ppbUserBlob.

[in, out] ppbUserBlob

Penunjuk ke BLOB kredensial yang dapat digunakan dalam autentikasi. Memori harus dikosongkan dengan memanggil EapHostPeerFreeMemory. Jika nilai non-null disediakan untuk parameter ini (artinya BLOB data yang ada diteruskan ke parameter ini), BLOB data yang disediakan akan diperbarui dan dikembalikan dalam parameter ini. Jika nilai BLOB non-NULL disediakan, fungsi LocalAlloc harus digunakan.

[out] ppEapError

Penunjuk ke penunjuk ke struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan memanggil EapHostPeerFreeErrorMemory.

Menampilkan nilai

Tidak ada

Keterangan

EapHostPeerQueryUserBlobFromCredentialInputFields mendukung SSO. Fungsi supplicant ini, seperti EapHostPeerQueryCredentialInputFields, hanya digunakan dalam skenario SSO.

Setelah EapHostPeerQueryUserBlobFromCredentialInputFields, EAPHost memanggil EapHostPeerBeginSession. Supplicant menggunakan bendera EAP_FLAG_PRE_LOGON di EapHostPeerBeginSession untuk menunjukkan bahwa EAPHost harus menyediakan SSO.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	eaphostpeerconfigapis.h
Pustaka	Eappcfg.lib
DLL	Eappcfg.dll

Lihat juga

Fungsi Konfigurasi EAPHost Supplicant

SSO dan PLAP

Bagikan melalui