Bagikan melalui

struktur EAP_PEER_METHOD_ROUTINES (eapmethodpeerapis.h)

Berisi sekumpulan penunjuk fungsi ke API Metode Peer EAPHost.

Sintaks

typedef struct _EAP_PEER_METHOD_ROUTINES {
  DWORD    dwVersion;
  EAP_TYPE *pEapType;
  DWORD((EAP_ERROR **ppEapError)   * )EapPeerInitialize;
  DWORD(flags,DWORD dwSizeofConnectionData, const BYTE *pConnectionData,DWORD dwSizeofUserData, const BYTE *pUserData,HANDLE hTokenImpersonateUser,BOOL *pfInvokeUI,DWORD *pdwSizeOfUserDataOut,BYTE **ppUserDataOut,LPWSTR *ppwszIdentity,EAP_ERROR **ppEapError)   * )(DWORD EapPeerGetIdentity;
  DWORD(RD dwFlags, const EapAttributes * const pAttributeArray,HANDLE hTokenImpersonateUser,DWORD dwSizeofConnectionData,BYTE *pConnectionData,DWORD dwSizeofUserData,BYTE *pUserData,DWORD dwMaxSendPacketSize,EAP_SESSION_HANDLE *pSessionHandle,EAP_ERROR **ppEapError)   * )(DWOEapPeerBeginSession;
  DWORD(AP_SESSION_HANDLE sessionHandle,WCHAR *pwszIdentity,WCHAR *pwszPassword,EAP_ERROR **ppEapError)   * )(EEapPeerSetCredentials;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD cbReceivePacket,EapPacket *pReceivePacket,EapPeerMethodOutput *pEapOutput,EAP_ERROR **ppEapError)   * )(EEapPeerProcessRequestPacket;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD *pcbSendPacket,EapPacket *pSendPacket,EAP_ERROR **ppEapError)   * )(EEapPeerGetResponsePacket;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EapPeerMethodResultReason reason,EapPeerMethodResult *pResult,EAP_ERROR **ppEapError)   * )(EapPeerGetResult;
  DWORD(P_SESSION_HANDLE sessionHandle,DWORD *pdwSizeOfUIContextData,BYTE **ppUIContextData,EAP_ERROR **ppEapError)   * )(EAEapPeerGetUIContext;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD dwSizeOfUIContextData, const BYTE *pUIContextData,EapPeerMethodOutput *pEapOutput,EAP_ERROR **ppEapError)   * )(EEapPeerSetUIContext;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EapAttributes *pAttribs,EAP_ERROR **ppEapError)   * )(EapPeerGetResponseAttributes;
  DWORD(AP_SESSION_HANDLE sessionHandle,EapAttributes *pAttribs,EapPeerMethodOutput *pEapOutput,EAP_ERROR **ppEapError)   * )(EEapPeerSetResponseAttributes;
  DWORD((EAP_SESSION_HANDLE sessionHandle,EAP_ERROR **ppEapError)   * )EapPeerEndSession;
  DWORD((EAP_ERROR **ppEapError)   * )EapPeerShutdown;
} EAP_PEER_METHOD_ROUTINES;

Anggota

dwVersion

Versi struktur yang ditentukan implementer.

Catatan Nilai untuk bidang ini tidak ditentukan oleh Microsoft.
 

pEapType

Penunjuk ke struktur EAP_TYPE yang berisi informasi vendor tentang pelaksana API yang ditujukkan oleh anggota struktur ini.

EapPeerInitialize

Penunjuk fungsi untuk EapPeerInitialize.

pEapError

Penunjuk ke struktur EAP_ERROR yang berisi kesalahan yang dimunculkan selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dibebaskan dengan meneruskan pointer ke EapPeerFreeErrorMemory.

EapPeerGetIdentity

Penunjuk fungsi untuk EapPeerGetIdentity.

dwflags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

dwSizeofConnectionData

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

pConnectionData

Penunjuk ke buffer byte yang berisi BLOB data konfigurasi buram.

dwSizeOfUserData

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

pUserData

Penunjuk ke data pengguna khusus untuk autentikasi ini yang digunakan untuk mengisi data pengguna sebelumnya. Ketika API ini dipanggil untuk pertama kalinya, atau ketika sesi autentikasi baru dimulai, parameter ini adalah NULL. Jika tidak, atur parameter ini ke anggota pUserData struktur yang diarahkan oleh parameter ppResult yang diterima oleh EapPeerGetResult.

hTokenImpersonateUser

Menentukan handel ke token peniruan identitas pengguna yang sedang diautentikasi. Handel ini akan menjadi NULL saat melakukan autentikasi mesin. Dengan menggunakan handel ini, metode EAP dapat meniru pengguna untuk tujuan mendapatkan informasi spesifik pengguna seperti nama pengguna, nama domain, dan kredensial.

pfInvokeUI

Mengembalikan TRUE jika identitas pengguna dan blob data pengguna tidak berhasil dikembalikan, dan metode berusaha mengumpulkan informasi dari pengguna melalui dialog antarmuka pengguna.

pdwSizeOfUserDataOut

Menentukan ukuran, dalam byte, dari buffer ppUserDataOut .

ppUserDataOut

Penunjuk ke penunjuk ke data pengguna yang dikembalikan. Data diteruskan ke EapPeerBeginSession sebagai pUserData input.

ppwszIdentity

Penunjuk ke identitas pengguna yang dikembalikan. Pointer akan disertakan dalam paket respons identitas dan dikembalikan ke server.

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.

EapPeerBeginSession

Penunjuk fungsi untuk EapPeerBeginSession.

dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP baru.

pAttributeArray

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

hTokenImpersonateUser

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

dwSizeOfConnectionData

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

pConnectionData

Penunjuk ke buffer byte yang berisi BLOB data konfigurasi buram.

dwSizeOfUserData

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

pUserData

Penunjuk ke buffer byte yang berisi BLOB data pengguna buram.

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.

pSessionHandle

Penunjuk ke struktur EAP_SESSION_HANDLE yang berisi ID unik untuk sesi autentikasi EAP baru di EAPHost

ppEapError

Arahkan ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang diajukan oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dibebaskan dengan memanggil EapPeerFreeErrorMemory.

EapPeerSetCredentials

Penunjuk fungsi untuk EapPeerSetCredentials.

sessionHandle

Penunjuk ke struktur EAP_SESSION_HANDLE yang berisi handel unik untuk sesi autentikasi EAP ini di server EAPHost. Handel ini dikembalikan dalam parameter pSessionHandle dalam panggilan sebelumnya ke EapPeerBeginSession.

pwszIdentity

Penunjuk yang menentukan identitas pengguna untuk mengatur kredensial. String identitas pengguna ini diperoleh dengan memanggil fungsi EapPeerGetIdentity .

pwszPassword

Penunjuk yang berisi kata sandi teks yang jelas untuk identitas pengguna.

ppEapError

Arahkan ke alamat 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.

EapPeerProcessRequestPacket

Penunjuk fungsi untuk EapPeerProcessRequestPacket.

sessionHandle

EAP_SESSION_HANDLE nilai yang berisi handel khusus untuk sesi autentikasi EAP di EAPHost. Handel ini diperoleh dengan panggilan sebelumnya ke EapPeerBeginSession.

cbReceivePacket

Ukuran dalam byte paket permintaan yang ditentukan dalam pReceivePacket.

pReceivePacket

Penunjuk ke struktur EapPacket yang berisi paket permintaan untuk diproses.

pEapOutput

Penunjuk ke struktur EapPeerMethodOutput yang berisi output operasi proses paket.

ppEapError

Arahkan ke alamat 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.

EapPeerGetResponsePacket

Penunjuk fungsi untuk EapPeerGetResponsePacket.

sessionHandle

EAP_SESSION_HANDLE nilai yang berisi handel khusus untuk sesi autentikasi EAP di EAPHost. Handel ini diperoleh dengan panggilan sebelumnya ke EapPeerBeginSession.

pcbSendPacket

Penunjuk ke nilai yang berisi ukuran dalam byte buffer yang dialokasikan untuk paket respons. Saat dikembalikan, parameter ini menerima pointer ke ukuran aktual dalam byte pSendPacket.

pSendPacket

Penunjuk ke struktur EapPacket yang berisi paket respons.

ppEapError

Arahkan ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan memanggilEapPeerFreeErrorMemory.

EapPeerGetResult

Penunjuk fungsi untuk EapPeerGetResult.

sessionHandle

EAP_SESSION_HANDLE nilai yang berisi handel khusus untuk sesi autentikasi EAP di EAPHost. Handel ini diperoleh dengan panggilan sebelumnya ke EapPeerBeginSession.

reason

Nilai enumerasi yang menentukan kode alasan untuk hasil autentikasi yang dikembalikan dalam ppResult.

ppResult

Penunjuk ke struktur EapHostPeerMethodResult yang berisi hasil autentikasi.

ppEapError

Arahkan ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan meneruskan pointer ke EapPeerFreeErrorMemory.

EapPeerGetUIContext

Penunjuk fungsi untuk EapPeerGetUIContext.

sessionHandle

EAP_SESSION_HANDLE nilai yang berisi handel khusus untuk sesi autentikasi EAP di EAPHost. Handel ini diperoleh dengan panggilan sebelumnya ke EapPeerBeginSession.

pdwSizeOfUIContextData

Penunjuk ke nilai yang menentukan ukuran buffer byte data konteks antarmuka pengguna yang dikembalikan dalam ppUIContextData.

ppUIContextData

Penunjuk ke alamat yang berisi buffer byte dengan data konteks antarmuka pengguna suppliant dari EAPHost.

ppEapError

Arahkan ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan meneruskan penunjuk ke data kesalahan ke EapPeerFreeErrorMemory.

EapPeerSetUIContext

Penunjuk fungsi untuk EapPeerSetUIContext.

sessionHandle

EAP_SESSION_HANDLE nilai yang berisi handel khusus untuk sesi autentikasi EAP di EAPHost. Handel ini diperoleh dengan panggilan sebelumnya ke EapPeerBeginSession.

dwSizeOfUIContextData

Penunjuk ke nilai yang menentukan ukuran buffer byte data konteks UI yang disediakan dalam pUIContextData.

pUIContextData

Penunjuk ke alamat yang berisi buffer byte dengan data konteks UI suppliant baru untuk diatur di EAPHost.

pEapOutput

Penunjuk ke struktur EapPeerMethodOutput yang berisi output operasi proses paket.

ppEapError

Arahkan ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan meneruskan pointer ke EapPeerFreeErrorMemory.

EapPeerGetResponseAttributes

Penunjuk fungsi untuk EapPeerGetResponseAttributes.

sessionHandle

EAP_SESSION_HANDLE nilai yang berisi handel khusus untuk sesi autentikasi EAP di EAPHost. Handel ini diperoleh dengan panggilan sebelumnya ke EapPeerBeginSession.

pAttribs

Menerima pointer ke struktur EAP_ATTRIBUTES yang berisi array atribut respons autentikasi EAP untuk supplicant.

ppEapError

Arahkan ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan memanggilEapPeerFreeErrorMemory.

EapPeerSetResponseAttributes

Penunjuk fungsi untuk EapPeerSetResponseAttributes.

sessionHandle

EAP_SESSION_HANDLE nilai yang berisi handel khusus untuk sesi autentikasi EAP di EAPHost. Handel ini diperoleh dengan panggilan sebelumnya ke EapPeerBeginSession.

pAttribs

Arahkan ke struktur EAP_ATTRIBUTES yang berisi array atribut respons autentikasi EAP baru untuk diatur untuk supplikasi di EAPHost.

pEapOutput

Penunjuk ke struktur EapPeerMethodOutput yang menentukan tindakan yang disarankan yang harus diambil oleh pemohon sebagai respons terhadap atribut yang diperbarui.

ppEapError

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

EapPeerEndSession

Penunjuk fungsi untuk EapPeerEndSession.

sessionHandle

EAP_SESSION_HANDLE nilai yang berisi handel khusus untuk sesi autentikasi EAP untuk ditutup di EAPHost. Handel ini diperoleh dengan panggilan sebelumnya ke EapPeerBeginSession.

ppEapError

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

EapPeerShutdown

Penunjuk fungsi untuk EapPeerShutdown.

ppEapError

Arahkan ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan meneruskan pointer ke EapPeerFreeErrorMemory.

Keterangan

Setiap DLL metode EAP harus mengimplementasikan API berikut:

API ini sesuai dengan panggilan yang dilakukan oleh pemohon, dan berfungsi sebagai proksi antara panggilan API pemohon dan API publik yang terekspos pada DLL metode EAP. Oleh karena itu, ketika pemohon melakukan panggilan ke EAPHost berbasis serekan untuk membuat sesi autentikasi atau untuk melakukan operasi selama sesi itu, EAPHost memanggil fungsi yang diterapkan yang sesuai pada metode EAP DLL dengan data parameter yang disediakan. Fungsi metode EAP dikelola oleh pointer ke titik masuk masing-masing.

Fungsi lain dalam set API Metode Peer EAP dipanggil oleh EAPHost berbasis serekan tanpa panggilan supplicant yang sesuai, dan digunakan untuk validasi koneksi atau operasi peningkatan antarmuka pengguna.

Persyaratan

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

Lihat juga

Struktur Metode Peer EAPHost

EapPeerGetInfo

  • Last updated on