Fonction de rappel VIRTUALCHANNELWRITE (cchannel.h)
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 .
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 |