interfaccia utente di configurazione Client-Side
Il fornitore che implementa il protocollo di autenticazione può anche fornire un'interfaccia utente di configurazione per il protocollo. L'interfaccia utente di configurazione può essere implementata nella stessa DLL del protocollo di autenticazione o in una DLL separata. Inoltre, la DLL che implementa l'interfaccia utente di configurazione può supportare più di un protocollo di autenticazione. Il percorso della DLL per l'interfaccia utente di configurazione viene archiviato nel valore del Registro di sistema RAS_EAP_VALUENAME_CONFIGUI, sotto la chiave per il protocollo di autenticazione. Per altre informazioni sulla creazione di questo valore del Registro di sistema, vedere Installazione EAP.
La DLL per l'interfaccia utente di configurazione deve esportare i punti di ingresso per le funzioni seguenti:
Quando l'utente crea una voce di configurazione per una connessione specifica, se per un client RAS o wireless, l'utente è in grado di selezionare il protocollo di autenticazione che il servizio deve usare con tale voce. Se il protocollo di autenticazione è configurabile, il servizio chiama RasEapInvokeConfigUI per richiamare l'interfaccia utente di configurazione. L'interfaccia utente di configurazione archivia le informazioni di configurazione restituite da RasEapInvokeConfigUI nella voce di configurazione.
Le informazioni di configurazione devono essere generice per tutti gli utenti nel computer client. Le informazioni specifiche di un determinato utente o utenti non devono essere archiviate nella voce. Il protocollo di autenticazione deve ottenere informazioni specifiche dell'utente usando le funzioni di identità o l'interfaccia utente interattiva. Il protocollo di autenticazione può archiviare queste informazioni nel Registro di sistema passandolo al servizio di autenticazione nel parametro pEapOutput di RasEapMakeMessage.
Le informazioni di configurazione non devono essere specifiche anche per il computer corrente; deve essere portabile dal computer al computer.
Quando il servizio di autenticazione chiama la funzione RasEapBegin per il protocollo di autenticazione, passa una struttura PPP_EAP_INPUT contenente un puntatore alle informazioni di configurazione. Al termine della chiamata a RasEapBegin , il servizio di autenticazione chiama RasEapFreeMemory per liberare la memoria occupata dalle informazioni di configurazione. Pertanto, il protocollo di autenticazione deve copiare le informazioni di configurazione in un buffer di memoria privato durante la chiamata a RasEapBegin.
Il fornitore può aggiungere un valore nella chiave del Registro di sistema per il protocollo di autenticazione che specifica le informazioni di configurazione predefinite per il protocollo. Il fornitore può anche aggiungere un valore che specifica se l'utente deve immettere le informazioni di configurazione quando creano una voce di rubrica telefonica. Per altre informazioni, vedere Valori del Registro di sistema del protocollo di autenticazione.