Partager via


Dialers personnalisés

Les systèmes d’exploitation Windows 2000 et ultérieur permettent aux développeurs de fournir leurs propres numéroteurs 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 pour 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 du répertoire téléphonique de 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 membre szCustomDialDll de la structure RASENTRY pour l’entrée du répertoire téléphonique.

Mise à jour du Registre pour les numéros 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ées. 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 du carnet de téléphone 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 numéroteurs personnalisés lors de l’ouverture de session système

Les systèmes d’exploitation Windows 2000 et ultérieur permettent à un utilisateur d’établir une connexion RAS au moment de l’ouverture de session. Pour ce faire, l’utilisateur vérifie l’ouverture de session à l’aide de la mise en réseau à distance dans la boîte de dialogue Informations de connexion. Une fois que l’utilisateur a cliqué 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é lors de l’ouverture de session, il fonctionne avec des privilèges système. Par conséquent, concevez le numéroteur personnalisé de sorte 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 permettant à l’utilisateur d’accéder en écriture au système de fichiers de l’ordinateur. Les interfaces utilisateur qui fournissent un tel accès incluent la boîte de dialogue Rechercher un fichier , la boîte de dialogue commune Ouvrir un fichier et l’aide de Windows.

L’interface utilisateur du numéroteur 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.