VIRTUALCHANNELOPEN-Rückruffunktion (cchannel.h)
Öffnet das Clientende eines virtuellen Kanals.
Remotedesktopdienste stellen einen Zeiger auf eine VirtualChannelOpen-Funktion in der CHANNEL_ENTRY_POINTS-Struktur bereit, die an Ihren VirtualChannelEntry-Einstiegspunkt übergeben wird.
Syntax
VIRTUALCHANNELOPEN Virtualchannelopen;
UINT VCAPITYPE Virtualchannelopen(
[in] LPVOID pInitHandle,
[out] LPDWORD pOpenHandle,
[in] PCHAR pChannelName,
[in] PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}
Parameter
[in] pInitHandle
Handle für die Clientverbindung. Dies ist das Handle, das im ppInitHandle-Parameter der VirtualChannelInit-Funktion zurückgegeben wird.
[out] pOpenHandle
Zeiger auf eine Variable, die ein Handle empfängt, das den geöffneten virtuellen Kanal in nachfolgenden Aufrufen der Funktionen VirtualChannelWrite und VirtualChannelClose identifiziert.
[in] pChannelName
Zeiger auf eine NULL-endende ANSI-Zeichenfolge, die den Namen des zu öffnenden virtuellen Kanals enthält. Der Name muss registriert worden sein, als der Client die VirtualChannelInit-Funktion aufgerufen hat.
[in] pChannelOpenEventProc
Zeiger auf eine anwendungsdefinierte VirtualChannelOpenEvent-Funktion , die Remotedesktopdienste aufruft, um die Client-DLL über Ereignisse für diesen virtuellen Kanal zu benachrichtigen.
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 Client-DLL kann diese Funktion erst aufrufen, wenn der Client eine Verbindung mit einem RD-Sitzungshostserver hergestellt hat. Ihre VirtualChannelInitEvent-Funktion empfängt eine CHANNEL_EVENT_CONNECTED Benachrichtigung, wenn eine Rd-Sitzungshostserververbindung hergestellt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | cchannel.h |