Partager via


RasSetAutodialParamA, fonction (ras.h)

La fonction RasSetAutodialParam définit la valeur d’un paramètre AutoDial.

Syntaxe

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

Paramètres

[in] unnamedParam1

Spécifie le paramètre AutoDial à définir. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
RASADP_DisableConnectionQuery
Le paramètre lpvValue pointe vers une valeur 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 une et que la base de données AutoDial a l’entrée de répertoire téléphonique à composer, AutoDial crée une connexion sans afficher la boîte de dialogue.
RASADP_LoginSessionDisable
Le paramètre lpvValue pointe vers une valeur DWORD . Si cette valeur est une, le système désactive toutes les connexions AutoDial pour la session d’ouverture de session active. Si cette valeur est égale à zéro (valeur par défaut), les connexions AutoDial sont activées. Le service système AutoDial remplace cette valeur par zéro lorsqu’un nouvel utilisateur se connecte à la station de travail.
RASADP_SavedAddressesLimit
Le paramètre lpvValue pointe vers une valeur DWORD qui indique le nombre maximal d’adresses stockées par AutoDial dans le Registre. AutoDial stocke d’abord les adresses qu’il a utilisées pour créer une connexion AutoDial ; il stocke ensuite les adresses qu’il 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 pointe vers une valeur DWORD qui indique une valeur de délai d’attente, en secondes. En cas d’échec d’une tentative de connexion AutoDial, 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 demande logique par une application. La valeur par défaut est cinq.
RASADP_ConnectionQueryTimeout
Le paramètre lpvValue pointe vers une valeur DWORD qui indique une valeur de délai d’attente, en secondes. Avant de tenter 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 a un minuteur de compte à rebours qui termine la boîte de dialogue par 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 de ce minuteur de compte à rebours.

[out] unnamedParam2

Pointeur vers une mémoire tampon qui contient la nouvelle valeur du paramètre spécifié.

[in] unnamedParam3

Spécifie la taille, en octets, de la valeur dans la mémoire tampon lpvValue .

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

Remarques

Notes

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

RasGetAutodialParam

RasSetAutodialAddress

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

Fonctions du service d’accès à distance