Метод IWTSVirtualChannel::Write (tsvirtualchannels.h)

Статья
03/11/2023

Запускает запрос на запись в канале. Все операции записи считаются асинхронными. При вызове этого метода копируется содержимое pBuffer и возвращается немедленно, чтобы буфер можно было освободить. Из-за копирования памяти слишком много вызовов Write() может привести к выделению слишком большого объема памяти клиентом.

Вызов Close() в этом канале отменит все ожидающие операции записи.

При использовании стека RDP существует максимальное ограничение в 1590 байт для каждого вызова этой функции. Вызов не завершится ошибкой, если это ограничение будет превышено. Более подробные сведения об ограничении см. в спецификации протокола DVC 2.2.3.1 DVC Data First PDU (DYNVC_DATA_FIRST)

Синтаксис

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

Параметры

[in] cbSize

Размер (в байтах) буфера, в который выполняется запись.

[in] pBuffer

Указатель на буфер в канале, в который записываются данные. Этот буфер можно использовать повторно, как только вызов вернется.

[in, optional] pReserved

Зарезервировано для последующего использования. Значение должно иметь значение NULL.

Возвращаемое значение

В случае успешного выполнения возвращает S_OK.

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	tsvirtualchannels.h

См. также раздел

IWTSVirtualChannel

Поделиться через