interfejs użytkownika konfiguracji Client-Side

Dostawca, który implementuje protokół uwierzytelniania, może również udostępnić interfejs użytkownika konfiguracji dla protokołu. Interfejs użytkownika konfiguracji może być zaimplementowany w tej samej biblioteki DLL co protokół uwierzytelniania lub w oddzielnej biblioteki DLL. Ponadto biblioteka DLL, która implementuje interfejs użytkownika konfiguracji, może obsługiwać więcej niż jeden protokół uwierzytelniania. Ścieżka do biblioteki DLL dla interfejsu użytkownika konfiguracji jest przechowywana w wartości rejestru RAS_EAP_VALUENAME_CONFIGUI w ramach klucza dla protokołu uwierzytelniania. Aby uzyskać więcej informacji na temat tworzenia tej wartości rejestru, zobacz instalacja protokołu EAP.

Biblioteka DLL dla interfejsu użytkownika konfiguracji powinna eksportować punkty wejścia dla następujących funkcji:

RasEapInvokeConfigUI

RasEapFreeMemory

Gdy użytkownik tworzy wpis konfiguracji dla określonego połączenia, niezależnie od tego, czy dla klienta RAS lub bezprzewodowego, użytkownik może wybrać protokół uwierzytelniania, którego usługa powinna używać z tym wpisem. Jeśli protokół uwierzytelniania jest konfigurowalny, usługa wywołuje RasEapInvokeConfigUI wywołać interfejs użytkownika konfiguracji. Interfejs użytkownika konfiguracji przechowuje informacje o konfiguracji zwrócone przez RasEapInvokeConfigUI we wpisie konfiguracji.

Informacje o konfiguracji powinny być ogólne dla wszystkich użytkowników na komputerze klienckim. Informacje specyficzne dla określonego użytkownika lub użytkowników nie powinny być przechowywane we wpisie. Protokół uwierzytelniania powinien uzyskać informacje specyficzne dla użytkownika przy użyciu funkcji tożsamości lub interaktywny interfejs użytkownika. Protokół uwierzytelniania może przechowywać te informacje w rejestrze, przekazując je do usługi uwierzytelniania w parametrze pEapOutputRasEapMakeMessage.

Informacje o konfiguracji nie powinny być również specyficzne dla bieżącej maszyny; powinien być przenośny z maszyny do maszyny.

Gdy usługa uwierzytelniania wywołuje funkcję RasEapBegin dla protokołu uwierzytelniania, przekazuje PPP_EAP_INPUT strukturę zawierającą wskaźnik do informacji o konfiguracji. Po zakończeniu wywołania RasEapBegin usługa uwierzytelniania wywołuje RasEapFreeMemory, aby zwolnić pamięć zajmowaną przez informacje o konfiguracji. W związku z tym protokół uwierzytelniania powinien skopiować informacje o konfiguracji do buforu pamięci prywatnej podczas wywołania polecenia RasEapBegin.

Dostawca może dodać wartość w kluczu rejestru dla protokołu uwierzytelniania, który określa domyślne informacje o konfiguracji protokołu. Dostawca może również dodać wartość określającą, czy użytkownik musi wprowadzić informacje o konfiguracji podczas tworzenia wpisu książki telefonicznej. Aby uzyskać więcej informacji, zobacz wartości rejestru protokołu uwierzytelniania .