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	Signification
RASCN_Connection	Si hrasconn est INVALID_HANDLE_VALUE, hEvent est signalé lors de la création d’une connexion RAS.
RASCN_Disconnection	hEvent est signalé lorsque la connexion hrasconn est terminée. Si hrasconn est une connexion multilink, l’événement est signalé lorsque toutes les sous-entités sont déconnectées. Si hrasconn est INVALID_HANDLE_VALUE, l’événement est signalé lors de l’arrêt d’une connexion RAS.
RASCN_BandwidthAdded	Windows NT : Si hrasconn est un handle à une connexion multilink combinée, hEvent est signalé lorsqu’une sous-entreprise est connectée.
RASCN_BandwidthRemoved	Windows NT : Si hrasconn est un handle d’une connexion multilink combinée, hEvent est signalé lorsqu’une sous-entreprise est déconnectée.

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

Voir aussi

CreateEvent

RasEnumConnections

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

Fonctions du service d’accès à distance