Función de devolución de llamada VIRTUALCHANNELOPEN (cchannel.h)

Artículo
02/26/2024

Abre el final del cliente de un canal virtual.

Servicios de Escritorio remoto proporciona un puntero a una función VirtualChannelOpen en la estructura CHANNEL_ENTRY_POINTS que se pasa al punto de entrada VirtualChannelEntry .

Sintaxis

VIRTUALCHANNELOPEN Virtualchannelopen;

UINT VCAPITYPE Virtualchannelopen(
  [in]  LPVOID pInitHandle,
  [out] LPDWORD pOpenHandle,
  [in]  PCHAR pChannelName,
  [in]  PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}

Parámetros

[in] pInitHandle

Identificador de la conexión de cliente. Este es el identificador devuelto en el parámetro ppInitHandle de la función VirtualChannelInit .

[out] pOpenHandle

Puntero a una variable que recibe un identificador que identifica el canal virtual abierto en llamadas posteriores a las funciones VirtualChannelWrite y VirtualChannelClose .

[in] pChannelName

Puntero a una cadena de caracteres ANSI terminada en null que contiene el nombre del canal virtual que se va a abrir. El nombre debe haberse registrado cuando el cliente llamó a la función VirtualChannelInit .

[in] pChannelOpenEventProc

Puntero a una función VirtualChannelOpenEvent definida por la aplicación que los servicios de Escritorio remoto llaman para notificar al archivo DLL de cliente de eventos de este canal virtual.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se CHANNEL_RC_OK.

Si se produce un error, la función devuelve uno de los valores siguientes.

Comentarios

El archivo DLL de cliente no puede llamar a esta función hasta que el cliente haya establecido una conexión con un servidor host de sesión de Escritorio remoto. La función VirtualChannelInitEvent recibe una notificación CHANNEL_EVENT_CONNECTED cuando se establece una conexión de servidor host de sesión de Escritorio remoto.