RasGetAutodialParamA, fonction (ras.h)

La fonction RasGetAutodialParam récupère la valeur d’un paramètre AutoDial.

Syntaxe

DWORD RasGetAutodialParamA(
  [in]      DWORD   unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

Paramètres

[in] unnamedParam1

Spécifie le paramètre AutoDial à récupérer. Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
RASADP_DisableConnectionQuery	Le paramètre lpvValue retourne une valeur de DWORD . Si cette valeur est égale à zéro (valeur par défaut), autoDial affiche une boîte de dialogue pour interroger l’utilisateur avant de créer une connexion. Si cette valeur est 1 et que la base de données AutoDial a l’entrée de carnet téléphonique à composer, AutoDial crée une connexion sans afficher la boîte de dialogue.
RASADP_LoginSessionDisable	Le paramètre lpvValue retourne une valeur de DWORD . Si cette valeur est 1, le système désactive toutes les connexions autoDiales pour la session d’ouverture de session actuelle. Si cette valeur est égale à zéro (valeur par défaut), les connexions autoDiales sont activées. Le service système AutoDial modifie cette valeur sur zéro lorsqu’un nouvel utilisateur se connecte à la station de travail.
RASADP_SavedAddressesLimit	Le paramètre lpvValue retourne une valeur de DWORD qui indique le nombre maximal d’adresses stockées par autoDial dans le Registre. AutoDial stocke d’abord les adresses qu’elle a utilisées pour créer une connexion autodiale ; puis il stocke les adresses qu’elle a apprises après la création d’une connexion RAS. Les adresses écrites à l’aide de la fonction RasSetAutodialAddress sont toujours enregistrées et ne sont pas incluses dans le calcul de la limite. La valeur par défaut est 100.
RASADP_FailedConnectionTimeout	Le paramètre lpvValue retourne une valeur DWORD qui indique une valeur de délai d’attente, en secondes. Lorsqu’une tentative de connexion autoDial échoue, le service système autoDial désactive les tentatives suivantes pour atteindre la même adresse pendant le délai d’attente. Cela empêche autoDial d’afficher plusieurs boîtes de dialogue de connexion pour la même requête logique par une application. La valeur par défaut est 5.
RASADP_ConnectionQueryTimeout	Le paramètre lpvValue pointe vers une valeur DWORD qui indique une valeur de délai d’attente, en secondes. Avant d’essayer une connexion autoDial, le système affiche une boîte de dialogue demandant à l’utilisateur de confirmer que le système doit composer. La boîte de dialogue comporte un minuteur de compte à rebours qui met fin à la boîte de dialogue avec une sélection « Ne pas composer » si l’utilisateur n’effectue aucune action. La valeur DWORD pointée par lpvValue spécifie l’heure initiale sur ce minuteur de compte à rebours.

[out] unnamedParam2

Pointeur vers une mémoire tampon qui reçoit la valeur du paramètre spécifié.

[in, out] unnamedParam3

Pointeur vers une valeur de DWORD .

Lors de l’entrée, définissez cette valeur pour indiquer la taille, en octets, de la mémoire tampon lpvValue.

En sortie, cette valeur indique la taille réelle de la valeur écrite dans la mémoire tampon.

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
ERROR_INVALID_PARAMETER	Le paramètre dwKey ou lpvValue n’est pas valide.
ERROR_INVALID_SIZE	La taille spécifiée par la lpdwcbValue est trop petite.

Remarques

Note

L’en-tête ras.h définit RasGetAutodialParam 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

RasSetAutodialAddress

RasSetAutodialParam

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

fonctions de service d’accès à distance