RasSetAutodialAddressA, fonction (ras.h)
La fonction RasSetAutodialAddress peut ajouter une adresse à la base de données de mappage automatique. Vous pouvez également supprimer ou modifier les données associées à une adresse existante dans la base de données.
Syntaxe
DWORD RasSetAutodialAddressA(
[in] LPCSTR unnamedParam1,
[in] DWORD unnamedParam2,
[in] LPRASAUTODIALENTRYA unnamedParam3,
[in] DWORD unnamedParam4,
[in] DWORD unnamedParam5
);
Paramètres
[in] unnamedParam1
Pointeur vers une chaîne null-terminated qui spécifie l’adresse à ajouter, supprimer ou modifier. Cette adresse peut être une adresse IP, un nom d’hôte Internet («www.microsoft.com») ou un nom NetBIOS (« products1 »).
Si ce paramètre est null, la fonction définit la connexion Internet par défaut (voir Remarques). Si ce paramètre pointe vers une chaîne de longueur nulle, la fonction supprime la connexion Internet par défaut.
[in] unnamedParam2
Réservé; doit être égal à zéro.
[in] unnamedParam3
Pointeur vers un tableau d’une ou plusieurs structures RASAUTODIALENTRY à associer à l’adresse lpszAddress. Si lpAutoDialEntries est NULL et dwcbAutoDialEntries est égal à zéro, RasSetAutodialAddress supprime toutes les structures associées à lpszAddress de la base de données de mappage.
[in] unnamedParam4
Spécifie la taille, en octets, de la mémoire tampon lpAutoDialEntries tampon.
[in] unnamedParam5
Spécifie le nombre de structures RASAUTODIALENTRY dans la mémoire tampon lpAutoDialEntries.
Valeur de retour
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants ou une valeur de Codes d’erreur d’acheminement et d’accès à distance ou Winerror.h.
| Valeur | Signification |
|---|---|
|
Le membre |
|
Le paramètre lpszAddress est NULL. |
|
Le nom de connexion spécifié dans lpAutoDialEntries n’existe pas. |
Remarques
Une adresse dans la base de données de mappage automatique peut avoir n’importe quel nombre d’entrées RASAUTODIALENTRY associées. Chaque entrée spécifie des informations autoDiales pour un emplacement de numérotation TAPI particulier.
Si l’adresse spécifiée par le paramètre lpszAddress est une adresse existante dans la base de données et que le paramètre lpAutoDialEntries n’est pas NULL, la fonction RasSetAutodialAddress modifie l’ensemble d’entrées AutoDial associées à l’adresse. Si une entrée dans l'lpAutoDialEntries tableau spécifie un emplacement de numérotation pour lequel l’adresse a déjà une entrée, la fonction remplace l’entrée existante par la nouvelle entrée. Sinon, la fonction ajoute simplement l'lpAutoDialEntries entrées au jeu d’entrées de l’adresse.
Si l’adresse lpszAddress existe dans la base de données, lpAutoDialEntries est NULL et lpAutoDialEntries est zéro, RasSetAutodialAddress supprime l’adresse de la base de données.
Si l’adresse lpszAddress n’existe pas dans la base de données, RasSetAutodialAddress ajoute l’adresse à la base de données. Le paramètre lpAutoDialEntries spécifie les entrées AutoDial à associer à la nouvelle adresse.
RAS prend en charge une connexion Internet par défaut globale à l’ordinateur local et prend en charge une connexion Internet par défaut pour chaque utilisateur.
Lorsque le paramètre lpszAddress est NULL et que le paramètre lpAutoDialEntries spécifie un nom de connexion avec une entrée, RasSetAutodialAddress définit la connexion comme connexion Internet par défaut. Le nom de connexion spécifié dans lpAutoDialEntries doit déjà exister. Si ce n’est pas le cas, ERROR_CANNOT_FIND_PHONEBOOK_ENTRY est retourné.
Lorsque le paramètre lpszAddress est une chaîne de longueur nulle et que le paramètre lpAutoDialEntries spécifie un nom de connexion vide avec une entrée, RasSetAutodialAddress supprime la connexion Internet par défaut.
Sur les ordinateurs clients non-domaine, si un utilisateur souhaite définir une connexion comme connexion Internet par défaut et spécifie une connexion « for-all-users » dans le szEntry membre de la structure RASAUTODIALENTRY, la connexion Internet par défaut est définie globalement sur l’ordinateur local. Dans tous les autres cas, la connexion Internet par défaut est définie pour chaque utilisateur de l’ordinateur individuellement.
Il est possible d’avoir deux connexions qui ont le même nom si une connexion « for-all-users » est configurée et l’autre est configurée comme une connexion « for-me-only ». Si le paramètre lpAutoDialEntries spécifie un nom de connexion qui correspond à une connexion globale et par utilisateur, la connexion par utilisateur est définie.
Note
L’en-tête ras.h définit RasSetAutodialAddress comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | ras.h |
| bibliothèque | Rasapi32.lib |
| DLL | Rasapi32.dll |
Voir aussi
Vue d’ensemble service d’accès à distance (RAS)