RasEapGetInfo-Funktion (raseapif.h)
Der RAS-Verbindungs-Manager ruft RasEapGetInfo auf, um eine Reihe von Funktionszeigern für ein angegebenes Authentifizierungsprotokoll abzurufen.
Syntax
DWORD RasEapGetInfo(
[in] DWORD dwEapTypeId,
[out] PPP_EAP_INFO *pEapInfo
);
Parameter
[in] dwEapTypeId
Gibt das Authentifizierungsprotokoll an, für das Informationen abgerufen werden sollen.
[out] pEapInfo
Zeiger auf eine PPP_EAP_INFO-Struktur . Die -Struktur empfängt Member, die RAS festlegt, um die Strukturversion und das Authentifizierungsprotokoll zu identifizieren, für das Funktionszeiger angefordert werden. Weitere Informationen finden Sie unter PPP_EAP_INFO.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, sollte der Rückgabewert ein geeigneter Fehlercode von Winerror.h, Raserror.h oder Mprerror.h sein.
Hinweise
Die DLL, die RasEapGetInfo implementiert, unterstützt möglicherweise mehr als ein Authentifizierungsprotokoll. Der dwEapTypeId-Parameter gibt an, für welches Authentifizierungsprotokoll Informationen abgerufen werden sollen.
Implementierungen von EAP müssen die RasEapGetInfo-Funktion exportieren, da RAS RasEapGetInfo verwendet, um Zeiger auf die anderen Authentifizierungsprotokollfunktionen abzurufen.
Nach der Initialisierung ruft der Verbindungs-Manager RasEapGetInfo für jede im Registrierungsunterschlüssel installierte EAP-DLL auf, wie in der EAP-Übersicht erläutert.
Wenn die Funktion einen anderen Wert als NO_ERROR zurückgibt, betrachtet RAS das Authentifizierungsprotokoll als nicht funktionsfähig. RAS sendet einen Fehler im Windows NT/Windows 2000-Ereignisprotokoll, um anzugeben, dass dieses Protokoll nicht ordnungsgemäß gestartet wurde und daher nicht verfügbar ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | raseapif.h |
Weitere Informationen
Übersicht über EAP (Extensible Authentication Protocol)