Função de retorno de chamada VIRTUALCHANNELWRITE (cchannel.h)

  • Artigo

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

Confira também

VirtualChannelOpen

VirtualChannelOpenEvent

WTSVirtualChannelRead