Partager via


Dialers personnalisés

Les systèmes d’exploitation Windows 2000 et ultérieurs permettent aux développeurs de fournir leurs propres dialers personnalisés qui fonctionnent avec le service d’accès à distance (RAS). Le numéroteur personnalisé est implémenté en tant que bibliothèque de liens dynamiques (DLL) unique qui exporte les points d’entrée suivants :

La DLL de numérotation personnalisée doit exporter tous ces points d’entrée et implémenter les points d’entrée en tant que fonctions Unicode. Pour plus d’informations sur ces fonctions, consultez la page de référence de chaque fonction dans la référence du service d’accès à distance du SDK Windows.

Pour qu’une connexion RAS utilise le numéroteur personnalisé, l’entrée de carnet téléphonique pour la connexion doit contenir le chemin d’accès à la DLL de numérotation personnalisée. Utilisez les fonctions d’API RAS RasGetEntryProperties et RasSetEntryProperties pour définir ce chemin dans le szCustomDialDll membre de la structure RASENTRY pour l’entrée de carnet téléphonique.

Mise à jour du Registre pour les dialers personnalisés

Pour que le système compose une connexion qui utilise un numéroteur personnalisé, le chemin d’accès à la DLL de numérotation personnalisée doit exister dans la valeur de Registre suivante.

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

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

Étant donné que CustomDLL est de type REG_MULTI_SZ, il peut contenir des chemins d’accès à plusieurs DLL de numérotation personnalisée. Vous devez définir le chemin d’accès à la DLL de numérotation personnalisée dans cette valeur de Registre, en plus de l’entrée de carnet téléphonique pour la connexion.

Par défaut, cette valeur de Registre est accessible en écriture uniquement par un utilisateur disposant de privilèges administrateur ou système. Pour des raisons de sécurité, ne modifiez pas les autorisations sur cette clé de Registre.

Utilisation de dialers personnalisés sur l’ouverture de session système

Les systèmes d’exploitation Windows 2000 et versions ultérieures permettent à un utilisateur d’établir une connexion RAS au moment de l’ouverture de session. Pour ce faire, l’utilisateur vérifie connexion à l’aide de la mise en réseau rendez-vous dans la boîte de dialogue Informations de connexion . Une fois que l’utilisateur clique sur le bouton Ok, le système affiche les connexions disponibles.

Considérations relatives à la sécurité

Dans la plupart des cas, un numéroteur personnalisé fonctionne avec les privilèges de sécurité de l’utilisateur qui l’appelle. Toutefois, si le numéroteur personnalisé est appelé à l’ouverture de session, il fonctionne avec des privilèges système. Par conséquent, concevez le numéroteur personnalisé afin qu’il ne puisse pas être utilisé pour violer la sécurité du système. Par exemple, le numéroteur ne doit pas présenter d’interface utilisateur qui permet à l’utilisateur d’accéder en écriture au système de fichiers de l’ordinateur. Les interfaces utilisateur qui fournissent ce type d’accès incluent la boîte de dialogue Rechercher un fichier, la boîte de dialogue fichier ouverte et windows Aide.

L’interface utilisateur de l’appelant personnalisé doit prendre en charge IDCANCEL

Si le numéroteur personnalisé affiche une interface utilisateur, l’interface utilisateur doit prendre en charge WM_COMMAND messages où LOWORD(wParam) est égal à IDCANCEL.