VirtualChannelOpenEx (Windows CE 5.0)

Send Feedback

This function opens the client end of a virtual channel. This function is a virtual extension that can be used to protect per-session data in the virtual channel client DLL.

typedef UINT VCAPITYPE VIRTUALCHANNELOPENEX(  LPVOID pInitHandle,  LPDWORD pOpenHandle,  PCHAR pChannelName,  PCHANNEL_OPEN_EVENT_EX_FN pChannelOpenEventProcEx);

Parameters

  • pInitHandle
    [in] Pointer to the handle to the client connection. This is the handle returned in the ppInitHandle parameter of the VirtualChannelInitEx function.
  • pOpenHandle
    [out] Pointer to a variable that receives a handle identifying the open virtual channel in subsequent calls to the VirtualChannelWriteEx and VirtualChannelCloseEx functions.
  • pChannelName
    [in] Pointer to a null-terminated string containing the name of the virtual channel to open. The name must have been registered when the client called VirtualChannelInitEx.
  • pChannelOpenEventProcEx
    [in] Pointer to an application-defined VirtualChannelOpenEventEx function that Terminal Services calls to notify the client DLL of events for this virtual channel. The following table shows possible values for this parameter.
    Value Description
    CHANNEL_EVENT_CONNECTED A connection has been established with a Terminal Server that supports virtual channels. pData points to a null-terminated string with the name of the server.
    CHANNEL_EVENT_DISCONNECTED The connection to the Terminal Server has been disconnected. pData is NULL.
    CHANNEL_EVENT_INITIALIZED The Remote Desktop client initialization has been completed. pData is NULL.
    CHANNEL_EVENT_TERMINATED The client has been terminated. pData is NULL.
    CHANNEL_EVENT_V1_CONNECTED A connection has been established with a Terminal Server that does not support virtual channels. pData is NULL.
    CHANNEL_RC_UNKNOWN_CHANNEL_NAME The channel is unregistered.

Return Values

The following table shows the return values for this function.

Value Description
CHANNEL_RC_OK Function succeeded.
CHANNEL_RC_BAD_INIT_HANDLE The pInitHandle parameter is not valid.

Remarks

Terminal Services provides a pointer to a VirtualChannelOpenEx function in the CHANNEL_ENTRY_POINTS_EX structure passed to your VirtualChannelEntryEx entry point.

The client DLL cannot call this function until the client has established a connection with a Terminal Server. Your VirtualChannelInitEventEx function receives a CHANNEL_EVENT_CONNECTED notification when a Terminal Server connection is established.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: Cchannel.h.
Link Library: Developer implemented.

See Also

RDP Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.