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

Inicia una solicitud de escritura en el canal. Todas las escrituras se consideran asincrónicas. Al llamar a este método, se copia el contenido de pBuffer y se devuelve inmediatamente, por lo que se puede reclamar el búfer. Debido a la copia de memoria, demasiadas llamadas Write() pueden dar lugar a que el cliente asigne demasiada memoria.

Una llamada a Close() en este canal cancelará las escrituras pendientes.

Cuando se usa la pila rdp, hay un límite máximo de 1590 bytes que se pueden escribir por llamada a esta función. No se producirá un error en la llamada si se supera este límite. Puede encontrar detalles más específicos sobre el límite en la especificación del protocolo DVC 2.2.3.1 DVC Data First PDU (DYNVC_DATA_FIRST)

Sintaxis

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

Parámetros

[in] cbSize

Tamaño, en bytes, del búfer en el que se va a escribir.

[in] pBuffer

Puntero a un búfer en el canal en el que se van a escribir los datos. Puede volver a usar este búfer en cuanto se devuelva la llamada.

[in, optional] pReserved

Reservado para uso futuro. El valor debe ser NULL.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente.

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	tsvirtualchannels.h

Consulte también

IWTSVirtualChannel