Fonction RasConnectionNotificationA (ras.h)
La fonction RasConnectionNotification spécifie un objet d’événement que le système définit à l’état signalé lors de la création ou de l’arrêt d’une connexion RAS.
Syntaxe
DWORD RasConnectionNotificationA(
[in] HRASCONN unnamedParam1,
[in] HANDLE unnamedParam2,
[in] DWORD unnamedParam3
);
Paramètres
[in] unnamedParam1
Handle de la connexion RAS qui reçoit les notifications. Il peut s’agir d’un handle retourné par la fonction RasDial ou RasEnumConnections . Si ce paramètre est INVALID_HANDLE_VALUE, des notifications sont reçues pour toutes les connexions RAS sur le client local.
[in] unnamedParam2
Spécifie le handle d’un objet d’événement. Utilisez la fonction CreateEvent pour créer un objet d’événement.
[in] unnamedParam3
Spécifie l’événement RAS qui amène le système à signaler l’objet d’événement spécifié par le paramètre hEvent . Ce paramètre est une combinaison des valeurs suivantes.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur autre que zéro provenant des codes d’erreur de routage et d’accès à distance ou winerror.h.
Remarques
Pour déterminer quand l’objet événement est signalé, utilisez l’une des fonctions d’attente.
Lorsque l’événement est signalé, utilisez d’autres fonctions RAS, telles que RasEnumConnections, pour obtenir plus d’informations sur la connexion RAS créée ou arrêtée.
Notes
L’en-tête ras.h définit RasConnectionNotification comme un 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.
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 |