Fonction de rappel VIRTUALCHANNELWRITE (cchannel.h)

Article
02/23/2024

Envoie des données de l’extrémité cliente d’un canal virtuel à une application partenaire sur le serveur.

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

Syntaxe

VIRTUALCHANNELWRITE Virtualchannelwrite;

UINT VCAPITYPE Virtualchannelwrite(
  [in] DWORD openHandle,
  [in] LPVOID pData,
  [in] ULONG dataLength,
  [in] LPVOID pUserData
)
{...}

Paramètres

[in] openHandle

Gérez vers le canal virtuel. Il s’agit du handle retourné dans le paramètre pOpenHandle de la fonction VirtualChannelOpen .

[in] pData

Pointeur vers une mémoire tampon contenant les données à écrire.

[in] dataLength

Spécifie le nombre d’octets des données dans la mémoire tampon pData à écrire.

[in] pUserData

Valeur définie par l’application. Cette valeur est passée à votre fonction VirtualChannelOpenEvent lorsque l’opération d’écriture est terminée ou annulée.

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 fonction VirtualChannelWrite est asynchrone. Une fois l’opération d’écriture terminée, votre fonction VirtualChannelOpenEvent reçoit une notification CHANNEL_EVENT_WRITE_COMPLETE. Tant que cette notification n’est pas reçue, l’appelant ne doit pas libérer ou réutiliser la mémoire tampon pData passée à VirtualChannelWrite.

La valeur spécifiée pour le paramètre pUserData est passée à votre fonction VirtualChannelOpenEvent lorsque l’opération d’écriture est terminée ou annulée. Vous pouvez utiliser ces données pour identifier l’opération d’écriture.

Le complément serveur à l’extrémité du serveur du canal virtuel appelle la fonction WTSVirtualChannelRead pour lire les données écrites par un appel VirtualChannelWrite .