Método IWTSSBPlugin::WTSSBX_GetUserExternalSession (tssbx.h)

[La interfaz IWTSSBPlugin no se admite después de Windows Server 2008 R2. A partir de Windows Server 2012 use la interfaz ITsSbPlugin.

Redirige una conexión entrante a un recurso informático, como una máquina virtual, un servidor de hoja o incluso el propio escritorio corporativo del usuario proporcionando una estructura de WTSSBX_MACHINE_CONNECT_INFO que contiene información sobre el recurso.

Sintaxis

HRESULT WTSSBX_GetUserExternalSession(
  [in]  WCHAR                       *UserName,
  [in]  WCHAR                       *DomainName,
  [in]  WCHAR                       *ApplicationType,
  [in]  WTSSBX_IP_ADDRESS           *RedirectorInternalIP,
  [out] DWORD                       *pSessionId,
  [out] WTSSBX_MACHINE_CONNECT_INFO *pMachineConnectInfo
);

Parámetros

[in] UserName

Puntero a una cadena Unicode que contiene el nombre de usuario de la conexión entrante.

[in] DomainName

Puntero a una cadena Unicode que contiene el nombre de dominio de la conexión entrante.

[in] ApplicationType

Puntero a una cadena Unicode que contiene el programa que se ejecuta Servicios de Escritorio remoto después de crear la sesión del usuario.

[in] RedirectorInternalIP

Puntero a la dirección IP interna del servidor host de sesión de Escritorio remoto que primero aceptó la conexión.

[out] pSessionId

Puntero al identificador de sesión de la sesión a la que el complemento redirige la conexión entrante.

[out] pMachineConnectInfo

Puntero a una estructura de WTSSBX_MACHINE_CONNECT_INFO que contiene información sobre el equipo al que el complemento dirige la conexión entrante.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente.

Comentarios

El Agente de sesión de Terminal Services (Agente de sesión de TS) llama a este método para que el complemento pueda redirigir una conexión entrante a un equipo que no está unido a una granja de servidores en el Agente de sesión de TS.

La implementación de WTSSBX_GetUserExternalSession debe devolver E_NOTIMPL si no admite el redireccionamiento a equipos que no están unidos a granjas de servidores en el Agente de sesión de TS.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	tssbx.h

Consulte también

ITsSbPlugin

IWTSSBPlugin