RasGetAutodialAddressA, fonction (ras.h)
La fonction RasGetAutodialAddress récupère des informations sur toutes les entrées autoDiales associées à une adresse réseau dans la base de données de mappage automatique.
Syntaxe
DWORD RasGetAutodialAddressA(
[in] LPCSTR unnamedParam1,
[in] LPDWORD unnamedParam2,
[in, out] LPRASAUTODIALENTRYA unnamedParam3,
[in, out] LPDWORD unnamedParam4,
[out] LPDWORD unnamedParam5
);
Paramètres
[in] unnamedParam1
Pointeur vers une chaîne null-terminated qui spécifie l’adresse pour laquelle les informations sont demandées. Il peut s’agir d’une adresse IP, d’un nom d’hôte Internet («www.microsoft.com») ou d’un nom NetBIOS (« products1 »).
Si ce paramètre est NULL, la fonction récupère la connexion Internet par défaut. La fonction retourne la connexion Internet par défaut par utilisateur si elle est configurée. Sinon, la fonction retourne la connexion Internet globale par défaut. Si aucune connexion Internet par défaut n’est configurée, la fonction retourne zéro pour les paramètres lpdwcbAutoDialEntries et lpdwcAutoDialEntries.
[in] unnamedParam2
Réservé; doit être NULL .
[in, out] unnamedParam3
Pointeur vers une mémoire tampon qui, en sortie, reçoit un tableau de structures RASAUTODIALENTRY, une pour chaque entrée autoDial associée à l’adresse spécifiée par le paramètre lpszAddress.
Lors de l’entrée, définissez le membre dwSize de la première structure RASAUTODIALENTRY dans la mémoire tampon sur sizeof(RASAUTODIALENTRY) pour identifier la version de la structure.
Si lpAutoDialEntries est NULL, RasGetAutodialAddress définit les paramètres lpdwcbAutoDialEntries et lpdwcAutoDialEntries pour indiquer la taille de mémoire tampon requise, en octets et le nombre d’entrées AutoDial.
[in, out] unnamedParam4
Pointeur vers une variable qui, en entrée, spécifie la taille, en octets, de la mémoire tampon lpAutoDialEntries tampon.
En sortie, cette variable reçoit le nombre d’octets retournés ou le nombre d’octets requis si la mémoire tampon est trop petite.
[out] unnamedParam5
Pointeur vers une variable qui reçoit le nombre d’éléments de structure retournés 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 |
|
LelpszAddress |
Remarques
Le service d’accès à distance (RAS) prend en charge les connexions Internet par défaut. RAS prend en charge une connexion Internet par défaut globale à l’ordinateur local, et en outre, prend en charge une connexion Internet par défaut pour chaque utilisateur.
Le nom de la connexion Internet par défaut globale est stocké dans le Registre sous la clé de Registre suivante :
HKEY_LOCAL_MACHINE Software Microsoft Ras Autodial Default
La valeur qui stocke le nom de la connexion est :
DefaultInternet
Cette valeur est de type REG_SZ.
La connexion Internet globale par défaut doit être configurée en tant que Pour tous les utilisateurs connexion dans le dossier connexions interface utilisateur.
Le nom de la connexion Internet par défaut par utilisateur est stocké dans le Registre sous la clé de Registre suivante :
HKEY_CURRENT_USER\Software\Microsoft\Ras Autodial\par défaut
La valeur qui stocke le nom de la connexion est :
DefaultInternet
Cette valeur est de type REG_SZ.
Note
L’en-tête ras.h définit RasGetAutodialAddress 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)