Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |