Fungsi EapPeerQueryCredentialInputFields (eapmethodpeerapis.h)

Menentukan implementasi fungsi khusus metode EAP yang mendapatkan bidang input kredensial Akses Menyeluruh (SSO) EAP untuk metode EAP.

Sintaks

DWORD EapPeerQueryCredentialInputFields(
  [in]  HANDLE                       hUserImpersonationToken,
  [in]  EAP_METHOD_TYPE              eapMethodType,
  [in]  DWORD                        dwFlags,
  [in]  DWORD                        dwEapConnDataSize,
  [in]  BYTE                         *pbEapConnData,
  [out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigFieldsArray,
  [out] EAP_ERROR                    **ppEapError
);

Parameter

[in] hUserImpersonationToken

Token peniruan identitas untuk pengguna yang kredensialnya akan diminta dan diperoleh.

[in] eapMethodType

Struktur EAP_METHOD_TYPE yang berisi informasi vendor dan penulis tentang metode EAP yang digunakan untuk mengautentikasi koneksi.

[in] dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

[in] dwEapConnDataSize

Ukuran data byte konfigurasi SSO EAP yang diacu oleh pbEapConnData, dalam byte.

[in] pbEapConnData

Pointer ke buffer byte buram yang berisi BLOB data konfigurasi EAP.

[out] pEapConfigFieldsArray

Penunjuk ke struktur EAP_CONFIG_INPUT_FIELD_ARRAY yang berisi bidang input untuk ditampilkan kepada pengguna yang mendukung. Bidang pwszData dalam elemen EAP_CONFIG_INPUT_FIELD_DATA individual diinisialisasi ke NULL.

[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.

Nilai kembali

Tidak ada

Keterangan

EapPeerQueryCredentialInputFields mendukung SSO. Fungsi metode serekan ini, seperti EapPeerQueryUserBlobFromCredentialInputFields, hanya digunakan dalam skenario SSO.

Implementasi khusus metode EAP dari fungsi ini dipanggil oleh EAPHost setiap kali aplikasi suppliant memanggil EapHostPeerQueryCredentialInputFields. Pelaksana fungsi ini bertanggung jawab untuk memastikan bahwa EAP_CONFIG_INPUT_FIELD_ARRAY yang dikembalikan oleh fungsi ini berisi definisi bidang input untuk setiap bagian data kredensial yang akan diminta metode EAP dari pengguna supplicant.

Persyaratan

Lihat juga

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO dan PLAP