Fungsi EapHostPeerGetMethodProperties (eaphostpeerconfigapis.h)

Fungsi EapHostPeerGetMethodProperties digunakan untuk mengambil properti metode EAP yang diberikan koneksi dan data pengguna.

Sintaks

DWORD EapHostPeerGetMethodProperties(
  [in]  DWORD                     dwVersion,
  [in]  DWORD                     dwFlags,
  [in]  EAP_METHOD_TYPE           eapMethodType,
  [in]  HANDLE                    hUserImpersonationToken,
  [in]  DWORD                     dwEapConnDataSize,
  [in]  const BYTE                *pbEapConnData,
  [in]  DWORD                     dwUserDataSize,
  [in]  const BYTE                *pbUserData,
  [out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
  [out] EAP_ERROR                 **ppEapError
);

Parameter

[in] dwVersion

Nomor versi API. Atur parameter ini ke nol.

[in] dwFlags

Kombinasi bendera EAP yang menjelaskan perilaku sesi autentikasi EAP.

[in] eapMethodType

Struktur EAP_METHOD_TYPE yang menentukan metode EAP yang digunakan pemohon.

[in] hUserImpersonationToken

Handel ke token peniruan identitas pengguna untuk digunakan dalam sesi ini.

[in] dwEapConnDataSize

Ukuran, dalam byte, dari buffer data koneksi yang disediakan dalam pbEapConnData.

[in] pbEapConnData

Data koneksi yang digunakan untuk metode EAP. Jika diatur ke NULL, properti statis metode , seperti yang dikonfigurasi dalam registri, dikembalikan.

[in] dwUserDataSize

Ukuran, dalam byte, dari buffer data pengguna yang disediakan dalam pbUserData.

[in] pbUserData

Penunjuk ke buffer byte yang berisi BLOB data pengguna buram. Parameter ini bisa NULL.

[out] pMethodPropertyArray

Penunjuk ke array properti metode EAP_METHOD_PROPERTY_ARRAY. Pemanggil harus membebaskan pointer dalam menggunakan EapHostPeerFreeMemory mulai dari pointer terdahulu. Pemanggil harus membebaskan nilai empvString hanya ketika jenisnya adalah empvtString.

[out] ppEapError

Penunjuk ke penunjuk ke struktur EAP_ERROR yang berisi kesalahan apa pun yang dimunculkan oleh EAPHost selama eksekusi panggilan fungsi ini. Setelah mengonsumsi data kesalahan, memori ini harus dikosongkan dengan meneruskan pointer ke EapHostPeerFreeErrorMemory.

Mengembalikan nilai

Tidak ada

Keterangan

EapHostPeerGetMethodProperties memungkinkan pengguna untuk mengambil properti metode EAP melalui antarmuka supplicant EAPHost. Properti yang dikembalikan oleh API ini mungkin berbeda dari properti yang dikembalikan oleh fungsi EapHostPeerGetMethods . Fungsi EapHostPeerGetMethodProperties mengembalikan properti metode EAP untuk koneksi dan data pengguna tertentu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	eaphostpeerconfigapis.h
Pustaka	Eappcfg.lib
DLL	Eappcfg.dll

Lihat juga

Fungsi Konfigurasi EAPHost Supplicant