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
ERROR_INVALID_SIZE	Le membre dwSize de la structure RASAUTODIALENTRY est une valeur non valide.
ERROR_INVALID_PARAMETER	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

Voir aussi

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasSetAutodialAddress

Vue d’ensemble du service d’accès à distance (RAS)

Fonctions du service d’accès à distance