Función WTSVirtualChannelOpen (wtsapi32.h)

Abre un identificador al final del servidor de un canal virtual especificado.

Esta función está obsoleta. En su lugar, use la función WTSVirtualChannelOpenEx .

Sintaxis

HANDLE WTSVirtualChannelOpen(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] LPSTR  pVirtualName
);

Parámetros

[in] hServer

Este parámetro debe ser WTS_CURRENT_SERVER_HANDLE.

[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 abrir un canal virtual en la sesión de otro usuario, debe tener permiso desde el canal virtual. Para obtener más información, consulte 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

Puntero a una cadena terminada en null que contiene el nombre del canal virtual. Tenga en cuenta que se trata de una cadena ANSI incluso cuando se define UNICODE. El nombre del canal virtual consta de uno para CHANNEL_NAME_LEN caracteres, no incluido el valor NULL de terminación.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el canal virtual especificado.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Cuando haya terminado de usar el identificador, suelte mediante una llamada a la función WTSVirtualChannelClose .

Para ver un ejemplo que muestra cómo obtener acceso a un identificador de archivo de canal virtual que se puede usar para E/S asincrónica, consulte WTSVirtualChannelQuery.

Si intenta usar esta función para abrir el mismo canal virtual varias veces, puede provocar un retraso de 10 segundos e interrumpir el canal 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

WTSEnumerateSessions

WTSOpenServer

WTSVirtualChannelClose