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) |