VIRTUALCHANNELOPEN-Rückruffunktion (cchannel.h)

Artikel
02/23/2024

Ö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