Fungsi EapPeerSetCredentials (eapmethodpeerapis.h)

Menyediakan kredensial autentikasi baru atau yang diperbarui ke metode EAP.

Sintaks

DWORD EapPeerSetCredentials(
  [in]  EAP_SESSION_HANDLE sessionHandle,
  [in]  LPWSTR             pwszIdentity,
  [in]  LPWSTR             pwszPassword,
  [out] EAP_ERROR          **ppEapError
);

Parameter

[in] sessionHandle

Penunjuk ke struktur EAP_SESSION_HANDLE yang berisi handel unik untuk sesi autentikasi EAP ini di server EAPHost. Handel ini dikembalikan dalam parameter pSessionHandle dalam panggilan sebelumnya ke EapPeerBeginSession.

[in] pwszIdentity

Penunjuk yang menentukan identitas pengguna untuk mengatur kredensial. String identitas pengguna ini diperoleh dengan memanggil fungsi EapPeerGetIdentity .

[in] pwszPassword

Penunjuk yang berisi kata sandi teks yang jelas untuk identitas pengguna.

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

Menampilkan nilai

Tidak ada

Keterangan

Jika kunci registri InvokeUserNameDlg diatur, EapPeerSetCredentials harus diekspor. Jika kunci registri InvokeUserNameDlg tidak diatur, EapPeerSetCredentials harus mengekspor fungsi EapPeerGetIdentity dan EapPeerInvokeIdentityUI .

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 Run-Time Metode Peer EAPHost

EapPeerGetIdentity

EapPeerInvokeIdentityUI

EapPeerSetCredentials