IWTSVirtualChannel::Write-Methode (tsvirtualchannels.h)
Startet eine Schreibanforderung für den Kanal. Alle Schreibvorgänge werden als asynchron betrachtet. Beim Aufrufen dieser Methode wird der Inhalt von pBuffer kopiert und sofort zurückgegeben, sodass der Puffer wieder beansprucht werden kann. Aufgrund der Speicherkopie können zu viele Write() -Aufrufe dazu führen, dass der Client zu viel Arbeitsspeicher zugibt.
Ein Close() -Aufruf in diesem Kanal bricht alle ausstehenden Schreibvorgänge ab.
Bei Verwendung des RDP-Stapels gibt es eine maximale Grenze von 1590 Bytes, die pro Aufruf dieser Funktion geschrieben werden können. Der Aufruf schlägt nicht fehl, wenn dieser Grenzwert überschritten wird. Genauere Details zum Grenzwert finden Sie in der DVC-Protokollspezifikation 2.2.3.1 DVC Data First PDU (DYNVC_DATA_FIRST).
Syntax
HRESULT Write(
[in] ULONG cbSize,
[in] BYTE *pBuffer,
[in, optional] IUnknown *pReserved
);
Parameter
[in] cbSize
Die Größe des Puffers, in den geschrieben werden soll, in Bytes.
[in] pBuffer
Ein Zeiger auf einen Puffer auf dem Kanal, in den die Daten geschrieben werden sollen. Sie können diesen Puffer wiederverwenden, sobald der Aufruf zurückgibt.
[in, optional] pReserved
Für die zukünftige Verwendung reserviert. Der Wert muss NULL sein.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | WindowsServer 2008 |
| Zielplattform | Windows |
| Kopfzeile | tsvirtualchannels.h |