Interface do usuário de configuração do Client-Side
O fornecedor que implementa o protocolo de autenticação também pode fornecer uma interface do usuário de configuração para o protocolo. A interface do usuário de configuração pode ser implementada na mesma DLL que o protocolo de autenticação ou em uma DLL separada. Além disso, a DLL que implementa a interface do usuário de configuração pode dar suporte a mais de um protocolo de autenticação. O caminho para a DLL para a interface do usuário de configuração é armazenado no valor do registro RAS_EAP_VALUENAME_CONFIGUI, na chave do protocolo de autenticação. Para obter mais informações sobre como criar esse valor de Registro, consulte Instalação do EAP.
A DLL para a interface do usuário de configuração deve exportar pontos de entrada para as seguintes funções:
Quando o usuário cria uma entrada de configuração para uma conexão específica, seja para um RAS ou cliente sem fio, o usuário pode selecionar o protocolo de autenticação que o serviço deve usar com essa entrada. Se o protocolo de autenticação for configurável, o serviço chamará RasEapInvokeConfigUI para invocar a interface do usuário de configuração. A interface do usuário de configuração armazena as informações de configuração retornadas por RasEapInvokeConfigUI na entrada de configuração.
As informações de configuração devem ser genéricas para todos os usuários no computador cliente. Informações específicas para um usuário ou usuário específico não devem ser armazenadas na entrada. O protocolo de autenticação deve obter informações específicas do usuário usando as funções de identidade ou a interface do usuário interativa. O protocolo de autenticação pode armazenar essas informações no registro passando-as para o serviço de autenticação no parâmetro pEapOutput de RasEapMakeMessage.
As informações de configuração também não devem ser específicas para o computador atual; ele deve ser portátil de computador para computador.
Quando o serviço de autenticação chama a função RasEapBegin para o protocolo de autenticação, ele passa uma estrutura PPP_EAP_INPUT que contém um ponteiro para as informações de configuração. Após a conclusão da chamada para RasEapBegin , o serviço de autenticação chama RasEapFreeMemory para liberar a memória ocupada pelas informações de configuração. Portanto, o protocolo de autenticação deve copiar as informações de configuração em um buffer de memória privada durante a chamada para RasEapBegin.
O fornecedor pode adicionar um valor sob a chave do Registro para o protocolo de autenticação que especifica informações de configuração padrão para o protocolo. O fornecedor também pode adicionar um valor que especifica se o usuário precisa inserir informações de configuração ao criar uma entrada de catálogo telefônico. Para obter mais informações, consulte Valores do Registro do Protocolo de Autenticação.