Partilhar via


Interface de usuário de configuração Client-Side

O fornecedor que implementa o protocolo de autenticação também pode fornecer uma interface do usuário (UI) 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 suportar mais de um protocolo de autenticação. O caminho para a DLL da interface do usuário de configuração é armazenado no valor do Registro RAS_EAP_VALUENAME_CONFIGUI, sob a chave do protocolo de autenticação. Para obter mais informações sobre como criar esse valor do Registro, consulte de Instalação EAP .

A DLL para a interface do usuário de configuração deve exportar pontos de entrada para as seguintes funções:

RasEapInvokeConfigUI

RasEapFreeMemory

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 é capaz de 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. As informações específicas de um determinado utilizador ou utilizadores não devem ser armazenadas na entrada. O protocolo de autenticação deve obter informações específicas do utilizador utilizando as funções de identidade ou interface de utilizador 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 da máquina atual; Deve ser portátil de máquina para máquina.

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 deve inserir informações de configuração ao criar uma entrada de catálogo telefônico. Para obter mais informações, consulte Authentication Protocol Registry Values.