Função de retorno de chamada VIRTUALCHANNELWRITE (cchannel.h)
Envia dados do final do cliente de um canal virtual para um aplicativo parceiro na extremidade do servidor.
Os Serviços de Área de Trabalho Remota fornecem um ponteiro para uma função VirtualChannelWrite na estrutura CHANNEL_ENTRY_POINTS passada para o ponto de entrada VirtualChannelEntry .
Sintaxe
VIRTUALCHANNELWRITE Virtualchannelwrite;
UINT VCAPITYPE Virtualchannelwrite(
[in] DWORD openHandle,
[in] LPVOID pData,
[in] ULONG dataLength,
[in] LPVOID pUserData
)
{...}
Parâmetros
[in] openHandle
Manipule para o canal virtual. Esse é o identificador retornado no parâmetro pOpenHandle da função VirtualChannelOpen .
[in] pData
Ponteiro para um buffer que contém os dados a serem gravados.
[in] dataLength
Especifica o número de bytes dos dados no buffer pData a ser gravado.
[in] pUserData
Um valor definido pelo aplicativo. Esse valor é passado para a função VirtualChannelOpenEvent quando a operação de gravação é concluída ou cancelada.
Retornar valor
Se a função for bem-sucedida, o valor retornado será CHANNEL_RC_OK.
Se ocorrer um erro, a função retornará um dos valores a seguir.
Comentários
A função VirtualChannelWrite é assíncrona. Quando a operação de gravação for concluída, sua função VirtualChannelOpenEvent receberá uma notificação de CHANNEL_EVENT_WRITE_COMPLETE. Até que essa notificação seja recebida, o chamador não deve liberar nem reutilizar o buffer pData passado para VirtualChannelWrite.
O valor especificado para o parâmetro pUserData é passado para a função VirtualChannelOpenEvent quando a operação de gravação é concluída ou cancelada. Você pode usar esses dados para identificar a operação de gravação.
O suplemento de servidor no final do servidor do canal virtual chama a função WTSVirtualChannelRead para ler os dados gravados por uma chamada VirtualChannelWrite .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | cchannel.h |