CHANNEL_INIT_EVENT_FN fonction de rappel (cchannel.h)

Article
02/23/2024

Fonction de rappel définie par l’application que les services Bureau à distance appellent pour notifier la DLL cliente des événements de canal virtuel.

Le type PCHANNEL_INIT_EVENT_FN définit un pointeur vers cette fonction de rappel. VirtualChannelInitEvent est un espace réservé pour le nom de fonction défini par l’application ou défini par la bibliothèque.

Syntaxe

CHANNEL_INIT_EVENT_FN ChannelInitEventFn;

VOID VCAPITYPE ChannelInitEventFn(
  [in] LPVOID pInitHandle,
  [in] UINT event,
  [in] LPVOID pData,
  [in] UINT dataLength
)
{...}

Paramètres

[in] pInitHandle

Gérer la connexion cliente. Il s’agit du handle retourné dans le paramètre ppInitHandle de la fonction VirtualChannelInit .

[in] event

Indique l’événement qui a provoqué la notification. Ce paramètre peut prendre les valeurs suivantes.

CHANNEL_EVENT_INITIALIZED (0)

L’initialisation du client de connexion Bureau à distance (RDC) a été effectuée. Le paramètre pData est NULL.

CHANNEL_EVENT_CONNECTED (1)

Une connexion a été établie avec un serveur hôte de session Bureau à distance qui prend en charge les canaux virtuels. Le paramètre pData est un pointeur vers une chaîne terminée par null avec le nom du serveur.

CHANNEL_EVENT_V1_CONNECTED (2)

Une connexion a été établie avec un serveur hôte de session Bureau à distance qui ne prend pas en charge les canaux virtuels. Le paramètre pData est NULL.

CHANNEL_EVENT_DISCONNECTED (3)

La connexion au serveur hôte de session Bureau à distance a été déconnectée. Le paramètre pData est NULL.

CHANNEL_EVENT_TERMINATED (4)

Le client a été arrêté. Le paramètre pData est NULL.

CHANNEL_EVENT_REMOTE_CONTROL_START (5)

Une opération de contrôle à distance a été démarrée. Le paramètre pData est NULL.

CHANNEL_EVENT_REMOTE_CONTROL_STOP (6)

Une opération de contrôle à distance a été terminée. Le paramètre pData est un pointeur vers une chaîne terminée par null contenant le nom du serveur.

[in] pData

Pointeur vers des données supplémentaires pour l’événement. Le type de données dépend de l’événement, comme décrit précédemment dans les descriptions des événements.

[in] dataLength

Spécifie la taille, en octets, des données dans la mémoire tampon pData .

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

La DLL cliente utilise la fonction VirtualChannelInit pour inscrire sa fonction VirtualChannelInitEvent auprès des services Bureau à distance.

Cette fonction est réentrante par handle. La fonction peut être appelée pendant son exécution, mais pas sur le même handle plusieurs fois.

Cette fonction est appelée uniquement une fois VirtualChannelEntry terminé.

CHANNEL_EVENT_CONNECTED et CHANNEL_EVENT_DISCONNECTED notifications d’événements ne sont pas envoyées si la connexion est transférée vers une autre session. Toutefois, le plug-in côté serveur qui administre la session vers laquelle la connexion est transférée reçoit une notification de reconnexion. Un outil côté serveur tel que Tscon.exe peut être utilisé pour transférer des connexions. Pour plus d’informations sur les notifications de reconnexion, consultez Supervision des Connections et des déconnexions de session.

Si le plug-in en mode utilisateur doit être averti qu’il a été reconnecté (par exemple, s’il doit réinitialiser son état), le plug-in côté serveur doit envoyer un message de notification au client. Cette notification doit utiliser le protocole que les plug-ins utilisent pour communiquer entre eux.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	cchannel.h

Voir aussi

VirtualChannelInit

Partager via