Función de devolución de llamada VIRTUALCHANNELOPEN (cchannel.h)
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.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows Vista |
Servidor mínimo compatible | Windows Server 2008 |
Plataforma de destino | Windows |
Encabezado | cchannel.h |