VIRTUALCHANNELOPEN, fonction de rappel (cchannel.h)

Article
02/26/2024

Ouvre l’extrémité cliente d’un canal virtuel.

Les services Bureau à distance fournissent un pointeur vers une fonction VirtualChannelOpen dans la structure CHANNEL_ENTRY_POINTS passée à votre point d’entrée VirtualChannelEntry .

Syntaxe

VIRTUALCHANNELOPEN Virtualchannelopen;

UINT VCAPITYPE Virtualchannelopen(
  [in]  LPVOID pInitHandle,
  [out] LPDWORD pOpenHandle,
  [in]  PCHAR pChannelName,
  [in]  PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}

Paramètres

[in] pInitHandle

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

[out] pOpenHandle

Pointeur vers une variable qui reçoit un handle qui identifie le canal virtuel ouvert dans les appels suivants aux fonctions VirtualChannelWrite et VirtualChannelClose .

[in] pChannelName

Pointeur vers une chaîne de caractères ANSI terminée par null contenant le nom du canal virtuel à ouvrir. Le nom doit avoir été inscrit lorsque le client a appelé la fonction VirtualChannelInit .

[in] pChannelOpenEventProc

Pointeur vers une fonction VirtualChannelOpenEvent définie par l’application que les services Bureau à distance appellent pour notifier la DLL cliente des événements pour ce canal virtuel.

Valeur retournée

Si la fonction réussit, la valeur de retour est CHANNEL_RC_OK.

Si une erreur se produit, la fonction retourne l’une des valeurs suivantes.

Remarques

La DLL cliente ne peut pas appeler cette fonction tant que le client n’a pas établi une connexion avec un serveur hôte de session Bureau à distance. Votre fonction VirtualChannelInitEvent reçoit une notification CHANNEL_EVENT_CONNECTED lorsqu’une connexion serveur hôte de session Bureau à distance est établie.