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 |