Funzione di callback VIRTUALCHANNELWRITE (cchannel.h)

Invia i dati dall'estremità client di un canale virtuale a un'applicazione partner sul lato server.

Servizi Desktop remoto fornisce un puntatore a una funzione VirtualChannelWrite nella struttura CHANNEL_ENTRY_POINTS passata al punto di ingresso VirtualChannelEntry .

Sintassi

VIRTUALCHANNELWRITE Virtualchannelwrite;

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

Parametri

[in] openHandle

Gestire il canale virtuale. Si tratta dell'handle restituito nel parametro pOpenHandle della funzione VirtualChannelOpen .

[in] pData

Puntatore a un buffer contenente i dati da scrivere.

[in] dataLength

Specifica il numero di byte dei dati nel buffer pData da scrivere.

[in] pUserData

Valore definito dall'applicazione. Questo valore viene passato alla funzione VirtualChannelOpenEvent quando l'operazione di scrittura viene completata o annullata.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è CHANNEL_RC_OK.

Se si verifica un errore, la funzione restituisce uno dei valori seguenti.

Commenti

La funzione VirtualChannelWrite è asincrona. Al termine dell'operazione di scrittura, la funzione VirtualChannelOpenEvent riceve una notifica CHANNEL_EVENT_WRITE_COMPLETE. Finché non viene ricevuta la notifica, il chiamante non deve liberare o riutilizzare il buffer pData passato a VirtualChannelWrite.

Il valore specificato per il parametro pUserData viene passato alla funzione VirtualChannelOpenEvent quando l'operazione di scrittura viene completata o annullata. È possibile usare questi dati per identificare l'operazione di scrittura.

Il componente aggiuntivo server alla fine del server del canale virtuale chiama la funzione WTSVirtualChannelRead per leggere i dati scritti da una chiamata VirtualChannelWrite .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	cchannel.h

Vedi anche

VirtualChannelOpen

VirtualChannelOpenEvent

WTSVirtualChannelRead