RasGetAutodialAddressA, fonction (ras.h)
La fonction RasGetAutodialAddress récupère des informations sur toutes les entrées AutoDial associées à une adresse réseau dans la base de données de mappage AutoDial.
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 terminée par null 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 a la valeur NULL, la fonction récupère la connexion Internet par défaut. La fonction retourne la connexion Internet par défaut par utilisateur si une connexion est configurée. Sinon, la fonction retourne la connexion Internet par défaut globale. 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és au; doit être NULL.
[in, out] unnamedParam3
Pointeur vers une mémoire tampon qui, à la 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 a la valeur 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, lors de l’entrée, spécifie la taille, en octets, de la mémoire tampon lpAutoDialEntries .
Lors de la 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 retournée
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 provenant des codes d’erreur de routage et d’accès à distance ou winerror.h.
| Valeur | Signification |
|---|---|
|
Le membre dwSize de la structure RASAUTODIALENTRY est une valeur non valide. |
|
Le paramètre lpszAddress, lpdwcbAutoDialEntries ou lpdwcAutoDialEntries était NULL. |
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 prend également 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 la suivante :
DefaultInternet
Cette valeur est de type REG_SZ.
La connexion Internet par défaut globale doit être configurée en tant que connexion Pour tous les utilisateurs dans l’interface utilisateur Connections Folder.
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\Logiciel\Microsoft\Ras Autodial\Par défaut
La valeur qui stocke le nom de la connexion est la suivante :
DefaultInternet
Cette valeur est de type REG_SZ.
Notes
L’en-tête ras.h définit RasGetAutodialAddress en tant qu’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. La combinaison 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ras.h |
| Bibliothèque | Rasapi32.lib |
| DLL | Rasapi32.dll |