VIRTUALCHANNELWRITE-Rückruffunktion (cchannel.h)
Sendet Daten vom Clientende eines virtuellen Kanals an eine Partneranwendung am Serverende.
Remotedesktopdienste stellen einen Zeiger auf eine VirtualChannelWrite-Funktion in der CHANNEL_ENTRY_POINTS Struktur bereit, die an Ihren VirtualChannelEntry-Einstiegspunkt übergeben wird.
Syntax
VIRTUALCHANNELWRITE Virtualchannelwrite;
UINT VCAPITYPE Virtualchannelwrite(
[in] DWORD openHandle,
[in] LPVOID pData,
[in] ULONG dataLength,
[in] LPVOID pUserData
)
{...}
Parameter
[in] openHandle
Handle mit dem virtuellen Kanal. Dies ist das Handle, das im pOpenHandle-Parameter der VirtualChannelOpen-Funktion zurückgegeben wird.
[in] pData
Zeiger auf einen Puffer, der die zu schreibenden Daten enthält.
[in] dataLength
Gibt die Anzahl der Bytes der zu schreibenden Daten im pData-Puffer an.
[in] pUserData
Ein anwendungsdefinierter Wert. Dieser Wert wird an Ihre VirtualChannelOpenEvent-Funktion übergeben, wenn der Schreibvorgang abgeschlossen oder abgebrochen wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert CHANNEL_RC_OK.
Wenn ein Fehler auftritt, gibt die Funktion einen der folgenden Werte zurück.
Hinweise
Die VirtualChannelWrite-Funktion ist asynchron. Nach Abschluss des Schreibvorgangs empfängt Ihre VirtualChannelOpenEvent-Funktion eine CHANNEL_EVENT_WRITE_COMPLETE Benachrichtigung. Bis diese Benachrichtigung empfangen wird, darf der Aufrufer den an VirtualChannelWrite übergebenen pData-Puffer nicht freigeben oder wiederverwenden.
Der für den pUserData-Parameter angegebene Wert wird an Ihre VirtualChannelOpenEvent-Funktion übergeben, wenn der Schreibvorgang abgeschlossen oder abgebrochen wird. Sie können diese Daten verwenden, um den Schreibvorgang zu identifizieren.
Das Server-Add-In am Serverende des virtuellen Kanals ruft die Funktion WTSVirtualChannelRead auf, um die von einem VirtualChannelWrite-Aufruf geschriebenen Daten zu lesen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | cchannel.h |