Función WTSVirtualChannelOpenEx (wtsapi32.h)

Crea un canal virtual de forma similar a WTSVirtualChannelOpen.

Esta API admite la creación de canales virtuales estáticos (SVC) y de canal virtual dinámico (DVC). Si el parámetro flags es cero, se comporta igual que WTSVirtualChannelOpen. Se puede abrir un DVC especificando la marca adecuada. Después de crear una DVC, puede usar las mismas funciones para Lectura, Escritura, Consulta o Cerrar que se usan para SVC.

Sintaxis

HANDLE WTSVirtualChannelOpenEx(
  [in] DWORD SessionId,
  [in] LPSTR pVirtualName,
  [in] DWORD flags
);

Parámetros

[in] SessionId

Identificador de sesión de Servicios de Escritorio remoto. Para indicar la sesión actual, especifique WTS_CURRENT_SESSION. Puede usar la función WTSEnumerateSessions para recuperar los identificadores de todas las sesiones en un servidor host de sesión de Escritorio remoto especificado.

Para poder abrir un canal virtual en la sesión de otro usuario, debe tener el permiso Canales virtuales. Para obtener más información, vea Permisos de Servicios de Escritorio remoto. Para modificar permisos en una sesión, use la herramienta administrativa Configuración de Servicios de Escritorio remoto.

[in] pVirtualName

En el caso de un SVC, apunta a una cadena terminada en NULL que contiene el nombre del canal virtual. La longitud de un nombre SVC se limita a CHANNEL_NAME_LEN caracteres, sin incluir el valor NULL de terminación.

En el caso de un DVC, apunta a una cadena terminada en null que contiene el nombre del punto de conexión del agente de escucha. La longitud de un nombre DVC se limita a MAX_PATH caracteres.

[in] flags

Para abrir el canal como SVC, especifique cero para este parámetro. Para abrir el canal como DVC, especifique WTS_CHANNEL_OPTION_DYNAMIC.

Al abrir un DVC, puede especificar una configuración de prioridad para los datos que se transfieren especificando uno de los valores WTS_CHANNEL_OPTION_DYNAMIC_PRI_XXX en combinación con el valor de WTS_CHANNEL_OPTION_DYNAMIC .

WTS_CHANNEL_OPTION_DYNAMIC_NO_COMPRESS

Deshabilita la compresión de este DVC. Debe especificar este valor en combinación con el valor WTS_CHANNEL_OPTION_DYNAMIC .

WTS_CHANNEL_OPTION_DYNAMIC_PRI_LOW (valor predeterminado)

Prioridad baja. Los datos se enviarán en ambos lados con prioridad baja. Use este nivel de prioridad para las transferencias de bloques de todos los tamaños, donde la velocidad de transferencia no es importante. En casi todos (95%) casos, el canal debe abrirse con esta marca.

WTS_CHANNEL_OPTION_DYNAMIC_PRI_MED

Prioridad media. Use este nivel de prioridad para enviar mensajes de control cortos que deben tener prioridad sobre los datos de los canales de prioridad baja.

WTS_CHANNEL_OPTION_DYNAMIC_PRI_HIGH

Prioridad alta. Use este nivel de prioridad para los datos críticos y que afectan directamente a la experiencia del usuario. El tamaño de la transferencia puede variar. Los datos de visualización se dividen en esta categoría.

WTS_CHANNEL_OPTION_DYNAMIC_PRI_REAL

Prioridad en tiempo real. Use este nivel de prioridad solo en los casos en los que la transferencia de datos sea absolutamente crítica. El tamaño de transferencia de datos debe limitarse a unos cientos de bytes por mensaje.

Valor devuelto

NULL al error con GetLastError establecido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wtsapi32.h
Library	Wtsapi32.lib
Archivo DLL	Wtsapi32.dll
Conjunto de API	ext-ms-win-session-wtsapi32-l1-1-0 (introducido en Windows 8)

Consulte también

API del servidor DVC

Referencia de canales virtuales dinámicos

WTSVirtualChannelOpen