EapPeerGetInfo-Funktion (eapmethodpeerapis.h)

  • Artikel

Ruft eine Reihe von Funktionszeigern für eine Implementierung der EAP-Peermethode EapPeerGetInfo ab, die derzeit in den EAPHost-Dienst geladen wird.

Syntax

DWORD EapPeerGetInfo(
  [in]  EAP_TYPE                 *pEapType,
  [out] EAP_PEER_METHOD_ROUTINES *pEapInfo,
  [out] EAP_ERROR                **ppEapError
);

Parameter

[in] pEapType

Ein Zeiger auf eine EAP_TYPE-Struktur , die die Anbieterdaten auf dem Implementierer der APIs enthält, auf die von den Membern dieser Struktur verwiesen wird.

[out] pEapInfo

Ein Zeiger auf eine EAP_PEER_METHOD_ROUTINES-Struktur , die die Funktionszeiger auf EAP-methodenspezifische Implementierungen der APIs enthält, die bittifizieren Aufrufen des peerbasierten EAPHost entsprechen.

[out] ppEapError

Ein Zeiger auf einen Zeiger auf eine EAP_ERROR-Struktur , die alle Fehler empfängt, die während der Ausführung dieses Funktionsaufrufs ausgelöst werden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher durch Aufrufen von EapPeerFreeErrorMemory freigegeben werden.

Rückgabewert

Keine

Bemerkungen

Jede DLL für EAP-Peermethoden muss die folgenden APIs implementieren:

Diese APIs entsprechen Aufrufen eines Supplicants und dienen als Proxy zwischen den API-Aufrufen des Supplicants und den öffentlichen APIs, die für die EAP-Methoden-DLL verfügbar gemacht werden. Wenn ein Supplicant daher einen peerbasierten EAPHost aufruft, um eine Authentifizierungssitzung einzurichten oder einen Vorgang während dieser Sitzung auszuführen, ruft der EAPHost die entsprechende implementierte Funktion für die EAP-Methoden-DLL mit den angegebenen Parametern auf. Die Funktionen der EAP-Methode werden von Zeigern auf die jeweiligen Einstiegspunkte verwaltet.

Die anderen Funktionen im EAP-Peermethoden-API-Satz werden von einem peerbasierten EAPHost ohne entsprechenden Bittaufruf aufgerufen und für Verbindungsüberprüfungs- oder Aufrufvorgänge der Benutzeroberfläche verwendet.

Dieser Aufruf wird von einem peerbasierten EAPHost mit einem Funktionszeiger auf diese API ausgeführt. Diese API muss für die von EAPHost geladene EAP-Methode implementiert werden und muss den in der Dokumentation angegebenen Syntax- und Parametertypen streng entsprechen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile eapmethodpeerapis.h

Weitere Informationen

EAPHost-Peermethode Run-Time Funktionen