CHANNEL_INIT_EVENT_FN Rückruffunktion (cchannel.h)
Eine anwendungsdefinierte Rückruffunktion, die remotedesktopdienste aufruft, um die Client-DLL über Ereignisse virtueller Kanäle zu benachrichtigen.
Der PCHANNEL_INIT_EVENT_FN Typ definiert einen Zeiger auf diese Rückruffunktion. VirtualChannelInitEvent ist ein Platzhalter für den anwendungsdefinierte oder bibliotheksdefinierte Funktionsnamen.
Syntax
CHANNEL_INIT_EVENT_FN ChannelInitEventFn;
VOID VCAPITYPE ChannelInitEventFn(
[in] LPVOID pInitHandle,
[in] UINT event,
[in] LPVOID pData,
[in] UINT dataLength
)
{...}
Parameter
[in] pInitHandle
Handle für die Clientverbindung. Dies ist das Handle, das im ppInitHandle-Parameter der VirtualChannelInit-Funktion zurückgegeben wird.
[in] event
Gibt das Ereignis an, das die Benachrichtigung verursacht hat. Dieser Parameter kann einen der folgenden Werte annehmen.
CHANNEL_EVENT_INITIALIZED (0)
Die RDC-Clientinitialisierung (Remotedesktopverbindung) wurde abgeschlossen. Der pData-Parameter ist NULL.
CHANNEL_EVENT_CONNECTED (1)
Es wurde eine Verbindung mit einem RD-Sitzungshostserver hergestellt, der virtuelle Kanäle unterstützt. Der pData-Parameter ist ein Zeiger auf eine NULL-endende Zeichenfolge mit dem Namen des Servers.
CHANNEL_EVENT_V1_CONNECTED (2)
Es wurde eine Verbindung mit einem RD-Sitzungshostserver hergestellt, der keine virtuellen Kanäle unterstützt. Der pData-Parameter ist NULL.
CHANNEL_EVENT_DISCONNECTED (3)
Die Verbindung mit dem RD-Sitzungshostserver wurde getrennt. Der pData-Parameter ist NULL.
CHANNEL_EVENT_TERMINATED (4)
Der Client wurde beendet. Der pData-Parameter ist NULL.
CHANNEL_EVENT_REMOTE_CONTROL_START (5)
Ein Remotesteuerungsvorgang wurde gestartet. Der pData-Parameter ist NULL.
CHANNEL_EVENT_REMOTE_CONTROL_STOP (6)
Ein Remotesteuerungsvorgang wurde beendet. Der pData-Parameter ist ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Servers enthält.
[in] pData
Zeiger auf zusätzliche Daten für das Ereignis. Der Typ der Daten hängt vom Ereignis ab, wie zuvor in den Ereignisbeschreibungen beschrieben.
[in] dataLength
Gibt die Größe der Daten im pData-Puffer in Bytes an.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Bemerkungen
Die Client-DLL verwendet die VirtualChannelInit-Funktion , um ihre VirtualChannelInitEvent-Funktion bei Remotedesktopdiensten zu registrieren.
Diese Funktion wird pro Handle wiederholt. Die Funktion kann aufgerufen werden, während sie ausgeführt wird, aber nicht mehr als einmal auf demselben Handle.
Diese Funktion wird erst aufgerufen, nachdem VirtualChannelEntry abgeschlossen wurde.
CHANNEL_EVENT_CONNECTED und CHANNEL_EVENT_DISCONNECTED Ereignisbenachrichtigungen werden nicht gesendet, wenn die Verbindung an eine andere Sitzung übertragen wird. Das serverseitige Plug-In, das die Sitzung verwaltet, in die die Verbindung übertragen wird, erhält jedoch eine Benachrichtigung über die erneute Verbindung. Ein serverseitiges Tool wie Tscon.exe kann zum Übertragen von Verbindungen verwendet werden. Weitere Informationen zu Benachrichtigungen zur erneuten Verbindung finden Sie unter Überwachen von sitzungsbasierten Connections und Verbindungstrennungen.
Wenn das Benutzermodus-Plug-In benachrichtigt werden muss, dass es wieder verbunden wurde (wenn es z. B. seinen Zustand zurücksetzen muss), sollte das serverseitige Plug-In eine Benachrichtigung an den Client senden. Diese Benachrichtigung sollte das Protokoll verwenden, das die Plug-Ins für die Kommunikation miteinander verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | cchannel.h |