IWTSVirtualChannel::Write メソッド (tsvirtualchannels.h)
チャネルで書き込み要求を開始します。 すべての書き込みは非同期と見なされます。 このメソッドを呼び出すと 、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 |
ヘッダー | tsvirtualchannels.h |