Fungsi EapPeerQueryInteractiveUIInputFields (eapmethodpeerapis.h)

Fungsi EapPeerQueryInteractiveUIInputFields mendefinisikan implementasi API metode EAP yang menyediakan bidang input untuk komponen UI interaktif yang akan dinaikkan pada supplicant.

Sintaks

DWORD EapPeerQueryInteractiveUIInputFields(
  [in]      DWORD                   dwVersion,
  [in]      DWORD                   dwFlags,
  [in]      DWORD                   dwSizeofUIContextData,
  [in]      const BYTE              *pUIContextData,
  [out]     EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [out]     EAP_ERROR               **ppEapError,
  [in, out] LPVOID                  *ppvReserved
);

Parameter

[in] dwVersion

Nomor versi API. Harus diatur ke nol.

[in] dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

[in] dwSizeofUIContextData

Ukuran data konteks dalam pUIContextData, dalam byte.

[in] pUIContextData

Penunjuk ke BLOB yang berisi data konteks UI, dinyatakan sebagai penunjuk dalam ke data bidang. Pemohon memperoleh pointer dalam ini dari API run-time EAPHost.

[out] pEapInteractiveUIData

Pointer yang menerima struktur EAP_INTERACTIVE_UI_DATA yang berisi informasi konfigurasi untuk komponen UI interaktif yang dinaikkan pada supplikasi EAP.

[out] 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 EapPeerFreeErrorMemory.

[in, out] ppvReserved

Disiapkan untuk penggunaan di masa mendatang. Harus diatur ke NULL

Nilai kembali

Tidak ada

Keterangan

EapPeerQueryInteractiveUIInputFields dapat digunakan untuk mendukung Akses Menyeluruh (SSO). Bendera EAP_FLAG_PRE_LOGON di EapPeerBeginSession menunjukkan kepada EAPHost bahwa SSO harus disediakan. Jika kode tindakan EapPeerResponseInvokeUI diterima setelah memanggil EapPeerBeginSession, EAPHost kemudian memanggil EapPeerQueryInteractiveUIInputFields, dan kemudian memanggil EapPeerQueryUIBlobFromInteractiveUIInputFields.

Pemohon harus memanggil selalu EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED dikembalikan, pemohon harus menggunakan model tradisional memanggil antarmuka pengguna interaktif metode dengan memanggil EapPeerInvokeInteractiveUI. Jika ada kesalahan, EapPeerQueryInteractiveUIInputFields akan mengembalikan kode pengembalian selain NULL.

Persyaratan

Lihat juga

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO dan PLAP