Fungsi EapPeerBeginSession (eapmethodpeerapis.h)

Artikel
08/23/2023

Memulai sesi autentikasi EAP pada peer EAPHost menggunakan metode EAP.

Sintaks

DWORD EapPeerBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  HANDLE                      hTokenImpersonateUser,
  [in]  DWORD                       dwSizeofConnectionData,
  [in]  BYTE                        *pConnectionData,
  [in]  DWORD                       dwSizeofUserData,
  [in]  BYTE                        *pUserData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Parameter

[in] dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP baru.

[in] pAttributeArray

Penunjuk ke struktur array EAP_ATTRIBUTES yang menentukan atribut EAP entitas untuk diautentikasi.

[in] hTokenImpersonateUser

Menentukan handel ke token peniruan identitas pengguna untuk digunakan dalam sesi ini.

[in] dwSizeofConnectionData

Menentukan ukuran, dalam byte, dari buffer data koneksi yang disediakan dalam pConnectionData.

[in] pConnectionData

Data koneksi khusus untuk metode ini digunakan untuk memutuskan data pengguna yang dikembalikan dari API ini, di mana data pengguna bergantung pada konfigurasi data koneksi tertentu. Ketika parameter ini NULL , implementasi metode harus menggunakan nilai default untuk koneksi.

[in] dwSizeofUserData

Menentukan ukuran dalam byte buffer data pengguna yang disediakan dalam pUserData.

[in] pUserData

Penunjuk ke buffer byte yang berisi BLOB data pengguna buram.

[in] dwMaxSendPacketSize

Menentukan ukuran maksimum dalam byte paket EAP yang dikirim selama sesi. Jika metode perlu mengirim paket yang lebih besar dari ukuran maksimum, metode harus mengakomodasi fragmentasi dan penyusunan ulang.

[out] pSessionHandle

Penunjuk ke struktur EAP_SESSION_HANDLE yang berisi handel unik untuk sesi autentikasi EAP ini di server EAPHost.

[out] ppEapError

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

Menampilkan nilai

Tidak ada

Keterangan

Panggilan ini dilakukan oleh EAPHost berbasis serekan menggunakan penunjuk fungsi ke API ini. API ini harus diimplementasikan pada metode EAP yang dimuat oleh EAPHost, dan harus benar-benar sesuai dengan jenis sintaks dan parameter yang ditentukan dalam dokumentasi.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	eapmethodpeerapis.h

Lihat juga

Fungsi Run-Time Metode Peer EAPHost

EapPeerEndSession

SSO dan PLAP

Bagikan melalui