RasGetConnectStatusA, fonction (ras.h)
La fonction RasGetConnectStatus récupère des informations sur l’état actuel de la connexion d’accès à distance spécifiée. Une application peut utiliser cet appel pour déterminer quand un appel RasDial asynchrone est terminé.
Syntaxe
DWORD RasGetConnectStatusA(
[in] HRASCONN unnamedParam1,
[in, out] LPRASCONNSTATUSA unnamedParam2
);
Paramètres
[in] unnamedParam1
Spécifie la connexion d’accès à distance pour laquelle récupérer l’état. Ce handle doit avoir été obtenu à partir de RasDial ou de RasEnumConnections.
[in, out] unnamedParam2
Pointeur vers la RASCONNSTATUS structure qui, en sortie, reçoit les informations d’état.
Lors de l’entrée, définissez le membre
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 |
|---|---|
|
La fonction n’a pas pu allouer suffisamment de mémoire pour terminer l’opération. |
Remarques
La valeur de retour de RasGetConnectStatus n’est pas nécessairement égale à la valeur du membre dwError du RASCONNSTATUS retourné par RasGetConnectStatus. La valeur de retour de RasGetConnectStatus indique les erreurs qui se produisent pendant l’appel de fonction RasGetConnectStatus, tandis que le membre dwError indique des erreurs qui empêchent l’établissement de la connexion.
Note
L’en-tête ras.h définit RasGetConnectStatus 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)