Méthode IWTSVirtualChannel::Write (tsvirtualchannels.h)

Article
03/11/2023

Démarre une demande d’écriture sur le canal. Toutes les écritures sont considérées comme asynchrones. L’appel de cette méthode copie le contenu de pBuffer et retourne immédiatement, afin que la mémoire tampon puisse être récupérée. En raison de la copie de la mémoire, un trop grand nombre d’appels Write() peut entraîner l’allocation de trop de mémoire par le client.

Un appel Close() sur ce canal annule toutes les écritures en attente.

Lors de l’utilisation de la pile RDP, il existe une limite maximale de 1 590 octets pouvant être écrits par appel à cette fonction. L’appel n’échoue pas si cette limite est dépassée. Vous trouverez des détails plus spécifiques sur la limite dans la spécification du protocole DVC 2.2.3.1 DVC Data First PDU (DYNVC_DATA_FIRST)

Syntaxe

HRESULT Write(
  [in]           ULONG    cbSize,
  [in]           BYTE     *pBuffer,
  [in, optional] IUnknown *pReserved
);

Paramètres

[in] cbSize

Taille, en octets, de la mémoire tampon dans laquelle écrire.

[in] pBuffer

Pointeur vers une mémoire tampon sur le canal dans lequel écrire les données. Vous pouvez réutiliser cette mémoire tampon dès que l’appel est retourné.

[in, optional] pReserved

Réservé pour un usage futur. La valeur doit être NULL.

Valeur retournée

Retourne S_OK en cas de réussite.

Configuration requise


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	tsvirtualchannels.h

Voir aussi

IWTSVirtualChannel

Partager via