Fungsi EapHostPeerGetResult (eappapis.h)
Mendapatkan hasil autentikasi untuk sesi autentikasi EAP yang ditentukan.
Sintaks
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] sessionHandle
Penunjuk ke struktur EAP_SESSIONID yang berisi handel unik untuk sesi autentikasi EAP ini di server EAPHost. Handel ini dikembalikan dalam parameter pSessionId dalam panggilan sebelumnya ke EapHostPeerBeginSession.
[in] reason
Nilai enumerasi EapHostPeerMethodResultReason yang menentukan kode alasan untuk hasil autentikasi yang dikembalikan di ppResult.
[out] ppResult
Penunjuk ke struktur EapHostPeerMethodResultReason yang berisi hasil autentikasi. EAPHost mengisi struktur ini dengan informasi terkait autentikasi yang ditentukan dalam EapHostPeerMethodResult.
[out] ppEapError
Penunjuk ke alamat struktur EAP_ERROR . Alamat harus diatur ke NULL sebelum memanggil fungsi ini. Jika data kesalahan tersedia, penunjuk ke alamat struktur EAP_ERROR yang berisi kesalahan yang dimunculkan selama eksekusi panggilan fungsi ini diterima. Pemohon harus merujuk ke parameter ini untuk menentukan apakah autentikasi berhasil. Setelah menggunakan data kesalahan, bebaskan memori ini dengan memanggil EapHostPeerFreeEapError.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR. Nilai yang dikembalikan tidak menunjukkan apakah autentikasi berhasil. Supplicant harus merujuk ke parameter ppEapError untuk menentukan hasil autentikasi.
Jika fungsi gagal, nilai yang dikembalikan harus merupakan kode kesalahan yang sesuai dari Winerror.h, Raserror.h, atau Mprerror.h.
Keterangan
Pemohon memanggil EapHostPeerGetResult setelah menyelesaikan autentikasi, yang dapat terjadi dalam salah satu skenario berikut.
- Panggilan ke EapHostPeerProcessReceivedPacket mengembalikan kode tindakan EapHostPeerResponseResult .
- Klien kehabisan waktu dan ingin mendapatkan hasil berdasarkan status saat ini.
- Pemohon menerima hasil alternatif, mungkin dari paket pada lapisan bawah.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | eappapis.h |
| Pustaka | Eappprxy.lib |
| DLL | Eappprxy.dll |