Método IWTSVirtualChannel::Write (tsvirtualchannels.h)

Artigo
03/11/2023

Inicia uma solicitação de gravação no canal. Todas as gravações são consideradas assíncronas. Chamar esse método copia o conteúdo de pBuffer e retorna imediatamente, para que o buffer possa ser recuperado. Devido à cópia de memória, muitas chamadas Write() podem resultar na alocação de muita memória pelo cliente.

Uma chamada Close() neste canal cancelará todas as gravações pendentes.

Ao usar a pilha RDP, há um limite máximo de 1590 bytes que podem ser gravados por chamada para essa função. A chamada não falhará se esse limite for excedido. Detalhes mais específicos sobre o limite podem ser encontrados na especificação de protocolo DVC 2.2.3.1 DVC Data First PDU (DYNVC_DATA_FIRST)

Sintaxe

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

Parâmetros

[in] cbSize

O tamanho, em bytes, do buffer no qual gravar.

[in] pBuffer

Um ponteiro para um buffer no canal no qual gravar os dados. Você pode reutilizar esse buffer assim que a chamada retornar.

[in, optional] pReserved

Reservado para uso futuro. O valor deve ser NULL.

Retornar valor

Retorna S_OK se tiver êxito.

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	tsvirtualchannels.h

Confira também

IWTSVirtualChannel

Compartilhar via