Freigeben über


Client-Side Konfigurations-Benutzeroberfläche

Der Anbieter, der das Authentifizierungsprotokoll implementiert, kann auch eine Konfigurations-Benutzeroberfläche (UI) für das Protokoll bereitstellen. Die Konfigurations-UI kann in derselben DLL wie das Authentifizierungsprotokoll oder in einer separaten DLL implementiert werden. Außerdem kann die DLL, die die Konfigurations-UI implementiert, mehrere Authentifizierungsprotokolle unterstützen. Der Pfad zur DLL für die Konfigurationsbenutzeroberfläche wird im Registrierungswert RAS_EAP_VALUENAME_CONFIGUI unter dem Schlüssel für das Authentifizierungsprotokoll gespeichert. Weitere Informationen zum Erstellen dieses Registrierungswerts finden Sie unter EAP-Installation.

Die DLL für die Konfigurations-Benutzeroberfläche sollte Einstiegspunkte für die folgenden Funktionen exportieren:

RasEapInvokeConfigUI-

RasEapFreeMemory

Wenn der Benutzer einen Konfigurationseintrag für eine bestimmte Verbindung erstellt, unabhängig davon, ob für einen RAS- oder Drahtlosclient, kann der Benutzer das Authentifizierungsprotokoll auswählen, das der Dienst mit diesem Eintrag verwenden soll. Wenn das Authentifizierungsprotokoll konfigurierbar ist, ruft der Dienst RasEapInvokeConfigUI- auf, um die Konfigurationsbenutzeroberfläche aufzurufen. Die Konfigurationsbenutzeroberfläche speichert die konfigurationsinformationen, die von RasEapInvokeConfigUI- im Konfigurationseintrag zurückgegeben werden.

Die Konfigurationsinformationen sollten für alle Benutzer auf dem Clientcomputer generisch sein. Informationen, die für einen bestimmten Benutzer oder Benutzer spezifisch sind, sollten nicht im Eintrag gespeichert werden. Das Authentifizierungsprotokoll sollte benutzerspezifische Informationen mithilfe der Identitätsfunktionen oder interaktiven Benutzeroberflächeabrufen. Das Authentifizierungsprotokoll kann diese Informationen in der Registrierung speichern, indem sie an den Authentifizierungsdienst im pEapOutput Parameter von RasEapMakeMessageübergeben.

Die Konfigurationsinformationen sollten auch nicht für den aktuellen Computer spezifisch sein; es sollte von Maschine zu Maschine portierbar sein.

Wenn der Authentifizierungsdienst die RasEapBegin--Funktion für das Authentifizierungsprotokoll aufruft, übergibt er eine PPP_EAP_INPUT Struktur, die einen Zeiger an die Konfigurationsinformationen enthält. Nach Abschluss des Aufrufs von RasEapBegin ruft der Authentifizierungsdienst RasEapFreeMemory auf, um den von den Konfigurationsinformationen belegten Speicher freizugeben. Daher sollte das Authentifizierungsprotokoll die Konfigurationsinformationen während des Aufrufs von RasEapBeginin einen privaten Speicherpuffer kopieren.

Der Anbieter kann unter dem Registrierungsschlüssel für das Authentifizierungsprotokoll einen Wert hinzufügen, der Standardkonfigurationsinformationen für das Protokoll angibt. Der Anbieter kann auch einen Wert hinzufügen, der angibt, ob der Benutzer Konfigurationsinformationen eingeben muss, wenn er einen Telefonbucheintrag erstellt. Weitere Informationen finden Sie unter Registrierungswerte des Authentifizierungsprotokolls.