Discadores personalizados

  • Artigo

Os sistemas operacionais Windows 2000 e posteriores permitem que os desenvolvedores forneçam seus próprios discadores personalizados que funcionam com o RAS (Serviço de Acesso Remoto). O discador personalizado é implementado como uma única DLL (biblioteca de vínculo dinâmico) que exporta os seguintes pontos de entrada:

A DLL de discagem personalizada deve exportar todos esses pontos de entrada e deve implementar os pontos de entrada como funções Unicode. Para obter mais informações sobre essas funções, consulte a página de referência para cada função na Referência do Serviço de Acesso Remoto do SDK do Windows.

Para que uma conexão RAS use o discador personalizado, a entrada do catálogo telefônico da conexão deve conter o caminho para a DLL de discagem personalizada. Use as funções de API RAS RasGetEntryProperties e RasSetEntryProperties para definir esse caminho no membro szCustomDialDll da estrutura RASENTRY para a entrada do catálogo telefônico.

Atualizando o Registro para Discadores Personalizados

Para que o sistema disce uma conexão que usa um discador personalizado, o caminho para a DLL de discagem personalizada deve existir no valor do Registro a seguir.

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            Rasman
               Parameters
                  CustomDLL<dl>
<dt>

                  Data type
</dt>
<dd>                  REG_MULTI_SZ</dd>
</dl>

Como CustomDLL é do tipo REG_MULTI_SZ, ele pode manter caminhos para várias DLLs de discagem personalizada. Você precisa definir o caminho para a DLL de discagem personalizada nesse valor do Registro, além da entrada do catálogo telefônico para a conexão.

Por padrão, esse valor do Registro é gravável somente por um usuário com privilégios de Administrador ou Sistema. Por motivos de segurança, não altere as permissões nessa chave do Registro.

Usando discadores personalizados no logon do sistema

Os sistemas operacionais Windows 2000 e posteriores permitem que um usuário estabeleça uma conexão RAS no momento do logon. Para fazer isso, o usuário verifica Logon usando Rede discada na caixa de diálogo Informações de Logon . Depois que o usuário clica no botão Ok, o sistema exibe as conexões disponíveis.

Considerações de segurança

Na maioria dos casos, um discador personalizado opera com os privilégios de segurança do usuário que o invoca. No entanto, se o discador personalizado for invocado no logon, ele funcionará com privilégios do sistema. Portanto, crie o discador personalizado para que ele não possa ser usado para violar a segurança do sistema. Por exemplo, o discador não deve apresentar uma interface do usuário que permita que o usuário escreva acesso ao sistema de arquivos do computador. As interfaces do usuário que fornecem esse acesso incluem a caixa de diálogo Localizar Arquivo , a caixa de diálogo comum Abrir Arquivo e a Ajuda do Windows.

A interface do usuário do discador personalizado deve dar suporte ao IDCANCEL

Se o discador personalizado exibir uma interface do usuário, a interface do usuário deverá dar suporte a mensagens WM_COMMAND em que LOWORD(wParam) é igual a IDCANCEL.