struktur EAP_AUTHENTICATOR_METHOD_ROUTINES (eapmethodauthenticatorapis.h)

Berisi sekumpulan penunjuk fungsi ke API Metode EAPHost Authenticator.

Sintaks

typedef struct _EAP_AUTHENTICATOR_METHOD_ROUTINES {
  DWORD           dwSizeInBytes;
  EAP_METHOD_TYPE *pEapType;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorInitialize;
  DWORD(ORD dwFlags,LPCWSTR pwszIdentity, const EapAttributes * const pAttributeArray,DWORD dwSizeofConnectionData, const BYTE * const pConnectionData,DWORD dwMaxSendPacketSize,EAP_SESSION_HANDLE *pSessionHandle,EAP_ERROR **ppEapError)          * )(DWEapMethodAuthenticatorBeginSession;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD dwFlags, const WCHAR *pwszIdentity, const EapAttributes * const pAttributeArray,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorUpdateInnerMethodParams;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD cbReceivePacket, const EapPacket * const pReceivePacket,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorReceivePacket;
  DWORD(P_SESSION_HANDLE sessionHandle,BYTE bPacketId,DWORD *pcbSendPacket,EapPacket *pSendPacket,EAP_AUTHENTICATOR_SEND_TIMEOUT *pTimeout,EAP_ERROR **ppEapError)          * )(EAEapMethodAuthenticatorSendPacket;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EapAttributes *pAttribs,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetAttributes;
  DWORD(AP_SESSION_HANDLE sessionHandle, const EapAttributes * const pAttribs,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorSetAttributes;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EAP_METHOD_AUTHENTICATOR_RESULT *pResult,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetResult;
  DWORD((EAP_SESSION_HANDLE sessionHandle,EAP_ERROR **ppEapError)          * )EapMethodAuthenticatorEndSession;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorShutdown;
} EAP_AUTHENTICATOR_METHOD_ROUTINES, *PEAP_AUTHENTICATOR_METHOD_ROUTINES;

Anggota

dwSizeInBytes

Versi struktur yang ditentukan pelaksana.

Catatan Nilai untuk bidang ini tidak ditentukan oleh Microsoft.
 

pEapType

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

EapMethodAuthenticatorInitialize

Penunjuk fungsi ke EapMethodAuthenticatorInitialize.

pEapType

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

ppEapError

Penunjuk ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang diangkat oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dibebaskan dengan meneruskan penunjuk ke data kesalahan ke EapPeerFreeErrorMemory.

EapMethodAuthenticatorBeginSession

Penunjuk fungsi ke EapMethodAuthenticatorBeginSession.

dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

pwszIdentity

String Unicode yang dihentikan nol yang berisi identitas pengguna untuk diautentikasi.

pAttributeArray

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

dwSizeOfConnectionData

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

pConnectionData

Penunjuk ke buffer byte yang berisi BLOB data konfigurasi buram.

dwMaxSendPacketSize

Menentukan ukuran maksimum, dalam byte, dari paket EAP yang dikirim selama sesi.

pSessionHandle

Menerima penunjuk ke struktur EAP_SESSION_HANDLE yang berisi ID unik untuk sesi autentikasi EAP baru di server EAPHost.

ppEapError

Penunjuk ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang diangkat oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dibebaskan dengan meneruskan penunjuk ke data kesalahan ke EapPeerFreeErrorMemory.

EapMethodAuthenticatorUpdateInnerMethodParams

Penunjuk fungsi ke EapMethodAuthenticatorUpdateInnerMethodParams.

sessionHandle

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

dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

pwszIdentity

String Unicode yang dihentikan nol yang berisi identitas pengguna yang diperbarui untuk diautentikasi.

pAttributeArray

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

ppEapError

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

EapMethodAuthenticatorReceivePacket

Penunjuk fungsi ke EapMethodAuthenticatorReceivePacket.

sessionHandle

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

cbReceivePacket

Ukuran, dalam byte, dari pReceivePacket.

pReceivePacket

Penunjuk ke struktur EapPacket yang berisi paket sesi autentikasi EAP yang diterima dari pemohon oleh server EAPHost.

pEapOutput

Menerima penunjuk ke nilai enumerasi EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION yang menunjukkan tindakan berikutnya yang harus dilakukan pemohon dalam sesi autentikasi EAP.

ppEapError

Penunjuk ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang diangkat oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dibebaskan dengan meneruskan penunjuk ke data kesalahan ke EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorSendPacket

Penunjuk fungsi ke EapMethodAuthenticatorSendPacket.

sessionHandle

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

bPacketId

Menentukan nilai ID numerik untuk dikirim paket.

pcbSendPacket

Menentukan ukuran maksimum, dalam byte, dari paket yang akan dikirim. Saat dikembalikan, parameter ini menerima ukuran, dalam byte, dari paket yang dikembalikan dalam pEapPacket.

pSendPacket

Menerima pointer ke struktur EapPacket yang berisi paket untuk dikirim ke pemohon.

pTimeout

Menerima pointer ke nilai EAP_AUTHENTICATOR_SEND_TIMEOUT yang menentukan batas waktu untuk paket.

ppEapError

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

EapMethodAuthenticatorGetAttributes

Penunjuk fungsi ke EapMethodAuthenticatorGetAttributes.

sessionHandle

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

pAttribs

Menerima penunjuk ke struktur EapAttributes yang berisi array atribut respons autentikasi EAP untuk supplicant.

ppEapError

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

EapMethodAuthenticatorSetAttributes

Penunjuk fungsi ke EapMethodAuthenticatorSetAttributes.

sessionHandle

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

pAttribs

Penunjuk ke struktur EapAttributes yang berisi array atribut respons autentikasi EAP baru untuk diatur untuk supplicant di EAPHost.

pEapOutput

Menerima penunjuk ke nilai enumerasi EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION yang menentukan tindakan yang disarankan yang harus diambil pemohon sebagai respons terhadap atribut yang diperbarui.

ppEapError

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

EapMethodAuthenticatorGetResult

Penunjuk fungsi ke EapMethodAuthenticatorGetResult.

sessionHandle

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

pResult

Menerima penunjuk ke struktur EAP_METHOD_AUTHENTICATOR_RESULT yang berisi hasil autentikasi.

ppEapError

Penunjuk ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang diangkat oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dibebaskan dengan meneruskan penunjuk ke data kesalahan ke EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorEndSession

Penunjuk fungsi ke EapMethodAuthenticatorEndSession.

sessionHandle

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

ppEapError

Penunjuk ke alamat struktur EAP_ERROR yang berisi kesalahan apa pun yang diangkat oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dibebaskan dengan meneruskan penunjuk ke data kesalahan ke EapMethodAuthenticatorFreeErrorMemory.

EapMethodAuthenticatorShutdown

Penunjuk fungsi ke EapMethodAuthenticatorShutdown.

pEapType

Nilai enumerasi EAP_METHOD_TYPE yang menentukan jenis autentikasi EAP yang digunakan dalam sesi.

ppEapError

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

Keterangan

Setiap DLL metode pengautentikasi EAP harus memiliki implementasi publik dari API berikut di dalamnya.

API ini dipanggil pada metode pengautentikasi EAP ketika pengautentikasi (server) EAPHost menerima panggilan prosedur jarak jauh tertentu yang sesuai dari metode EAP peer (klien). Perhatikan bahwa korespondensi satu-ke-satu lengkap tidak ada antara metode peer EAP dan metode pengautentikasi EAP; panggilan API metode pengautentikasi EAP tertentu harus dilakukan berdasarkan persyaratan implementasi Anda dari panggilan API metode pengautentikasi EAP.

Persyaratan

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

Lihat juga

Struktur Metode EAPHost Authenticator

EapMethodAuthenticatorGetInfo

  • Last updated on