Metodo IWTSVirtualChannel::Write (tsvirtualchannels.h)

Articolo
03/11/2023

Avvia una richiesta di scrittura nel canale. Tutte le scritture sono considerate asincrone. La chiamata a questo metodo copia il contenuto di pBuffer e restituisce immediatamente, in modo che il buffer possa essere recuperato. A causa della copia di memoria, un numero eccessivo di chiamate Write() può comportare l'allocazione di una quantità eccessiva di memoria da parte del client.

Una chiamata Close() su questo canale annulla tutte le scritture in sospeso.

Quando si usa lo stack RDP, è previsto un limite massimo di 1590 byte che può essere scritto per ogni chiamata a questa funzione. La chiamata non avrà esito negativo se questo limite viene superato. Per informazioni più specifiche sul limite, vedere la specifica del protocollo DVC 2.2.3.1 DVC Data First PDU (DYNVC_DATA_FIRST)

Sintassi

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

Parametri

[in] cbSize

Dimensione, in byte, del buffer in cui scrivere.

[in] pBuffer

Puntatore a un buffer sul canale in cui scrivere i dati. È possibile riutilizzare questo buffer non appena viene restituita la chiamata.

[in, optional] pReserved

Riservato per utilizzi futuri. Il valore deve essere NULL.

Valore restituito

Restituisce S_OK in caso di esito positivo.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	tsvirtualchannels.h

Vedi anche

IWTSVirtualChannel

Condividi tramite