Fungsi EapPeerInvokeIdentityUI (eapmethodpeerapis.h)

Menaikkan dialog antarmuka pengguna interaktif kustom untuk mendapatkan informasi identitas pengguna untuk metode EAP pada klien.

Sintaks

DWORD EapPeerInvokeIdentityUI(
  [in]  EAP_METHOD_TYPE *pEapType,
  [in]  DWORD           dwFlags,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwSizeOfConnectionData,
  [in]  const BYTE      *pConnectionData,
  [out] DWORD           dwSizeOfUserData,
  [in]  const BYTE      *pUserData,
  [out] DWORD           *pdwSizeOfUserDataOut,
  [out] BYTE            **ppUserDataOut,
  [out] LPWSTR          *ppwszIdentity,
  [out] EAP_ERROR       **ppEapError
);

Parameter

[in] pEapType

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] hwndParent

Handel ke jendela induk yang akan menghasilkan dialog antarmuka pengguna interaktif untuk mendapatkan data identitas.

[in] dwSizeOfConnectionData

Ukuran, dalam byte, dari data konteks antarmuka pengguna yang ditentukan oleh pUIContextData.

[in] pConnectionData

Penunjuk ke buffer byte buram yang berisi data koneksi.

[out] dwSizeOfUserData

Menentukan ukuran, dalam byte, dari data identitas pengguna yang dikembalikan di dwSizeOfUserData.

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

[out] pdwSizeOfUserDataOut

Menentukan ukuran, dalam byte, dari buffer ppUserDataOut .

[out] ppUserDataOut

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

[out] ppwszIdentity

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

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

Menampilkan nilai

Tidak ada

Keterangan

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

Persyaratan

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

Lihat juga

Fungsi Konfigurasi Metode Peer EAPHost

EapPeerInvokeIdentityUI