Compartilhar via


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 (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 do Registro, consulte de 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:

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. 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 interativas de interface do usuário. 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. Depois que a chamada para RasEapBegin for concluída, o serviço de autenticação chamará 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 privado 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 é necessário para inserir informações de configuração ao criar uma entrada de lista telefônica. Para obter mais informações, consulte Valores do Registro de Protocolo de Autenticação.