Fungsi EapPeerGetIdentity (eapmethodpeerapis.h)

Mengembalikan data pengguna dan identitas pengguna setelah dipanggil oleh EAPHost.

Sintaks

DWORD EapPeerGetIdentity(
  [in]      DWORD      dwFlags,
  [in]      DWORD      dwSizeofConnectionData,
  [in]      const BYTE *pConnectionData,
  [in]      DWORD      dwSizeofUserData,
  [in]      const BYTE *pUserData,
  [in]      HANDLE     hTokenImpersonateUser,
  [out]     BOOL       *pfInvokeUI,
  [in, out] DWORD      *pdwSizeOfUserDataOut,
  [out]     BYTE       **ppUserDataOut,
  [out]     LPWSTR     *ppwszIdentity,
  [out]     EAP_ERROR  **ppEapError
);

Parameter

[in] dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

[in] dwSizeofConnectionData

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

[in] pConnectionData

Penunjuk ke buffer byte yang berisi BLOB data konfigurasi buram.

[in] dwSizeofUserData

Menentukan ukuran, dalam byte, dari buffer data pengguna yang disediakan di pUserData.

[in] pUserData

Penunjuk ke data pengguna khusus untuk autentikasi ini yang digunakan untuk mengisi data pengguna terlebih dahulu. 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 diacu oleh parameter ppResult yang diterima oleh EapPeerGetResult.

[in] hTokenImpersonateUser

Menentukan handel ke token peniruan identitas pengguna yang diautentikasi. Handel ini akan null ketika melakukan autentikasi mesin. Dengan menggunakan handel ini, metode EAP dapat meniru pengguna untuk tujuan mendapatkan informasi spesifik pengguna seperti nama pengguna, nama domain, dan kredensial.

[out] pfInvokeUI

Mengembalikan TRUE jika identitas pengguna dan blob data pengguna tidak berhasil dikembalikan, dan metode berusaha mengumpulkan informasi dari pengguna melalui dialog antarmuka pengguna.

[in, out] pdwSizeOfUserDataOut

Menentukan ukuran, dalam byte, dari buffer ppUserDataOut .

[out] ppUserDataOut

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

[out] ppwszIdentity

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

[out] ppEapError

Penunjuk ke penunjuk ke struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan memanggil EapPeerFreeErrorMemory.

Menampilkan nilai

Tidak ada

Keterangan

Panggilan ini dilakukan oleh EAPHost berbasis peer menggunakan penunjuk fungsi ke API ini. API ini harus diimplementasikan pada metode EAP yang dimuat oleh EAPHost, dan harus benar-benar sesuai dengan sintaksis dan jenis 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 Run-Time Metode Peer EAPHost

EapPeerInvokeIdentityUI