Fungsi EapMethodAuthenticatorBeginSession (eapmethodauthenticatorapis.h)

  • Artikel

Membuat sesi autentikasi EAP baru di server EAPHost.

EapMethodAuthenticatorBeginSession adalah prototipe fungsi.

Sintaks

DWORD EapMethodAuthenticatorBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  BYTE                        bInitialId,
        LPCWSTR                     pwszIdentity,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  DWORD                       dwSizeofConnectionData,
        const BYTE * const          pConnectionData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Parameter

[in] dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

[in] bInitialId

Untai (karakter) Unicode yang dihentikan nol yang berisi identitas pengguna untuk diautentikasi.

pwszIdentity

Identitas pengguna yang diautentikasi.

[in] pAttributeArray

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

[in] dwSizeofConnectionData

Menentukan ukuran dalam byte data yang diarahkan oleh pConnectionData. Jika pConnectionData adalah NULL, anggota ini adalah nol.

pConnectionData

Arahkan ke data koneksi yang diterima dari antarmuka pengguna konfigurasi protokol autentikasi.

[in] dwMaxSendPacketSize

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

[out] pSessionHandle

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

[out] ppEapError

Secara opsional menerima penunjuk ke penunjuk ke struktur EAP_ERROR yang berisi kesalahan yang dimunculkan oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dibebaskan dengan meneruskan penunjuk ke data kesalahan ke EapMethodAuthenticatorFreeMemory.

Nilai kembali

Tidak ada

Keterangan

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

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 eapmethodauthenticatorapis.h

Lihat juga

Fungsi Metode Autentikator EAPHost

EapHostPeerBeginSession