Método IWTSSBPlugin::WTSSBX_GetUserExternalSession (tssbx.h)
[A interface IWTSSBPlugin não tem suporte após o Windows Server 2008 R2. Começando com Windows Server 2012 use a interface ITsSbPlugin.]
Redireciona uma conexão de entrada para um recurso de computação, como uma máquina virtual, um servidor de folhas ou até mesmo a própria área de trabalho corporativa do usuário, fornecendo uma estrutura WTSSBX_MACHINE_CONNECT_INFO que contém informações sobre o recurso.
Sintaxe
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
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome de usuário da conexão de entrada.
[in] DomainName
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome de domínio da conexão de entrada.
[in] ApplicationType
Um ponteiro para uma cadeia de caracteres Unicode que contém o programa que os Serviços de Área de Trabalho Remota executam após a criação da sessão do usuário.
[in] RedirectorInternalIP
Um ponteiro para o endereço IP interno do servidor Host da Sessão de Área de Trabalho Remota que primeiro aceitou a conexão.
[out] pSessionId
Um ponteiro para a ID da sessão para a qual o plug-in está redirecionando a conexão de entrada.
[out] pMachineConnectInfo
Um ponteiro para uma estrutura WTSSBX_MACHINE_CONNECT_INFO que contém informações sobre o computador para o qual o plug-in está direcionando a conexão de entrada.
Retornar valor
Retorna S_OK se tiver êxito.
Comentários
O Agente de Sessão de Serviços de Terminal (Agente de Sessão do TS) chama esse método para que o plug-in possa redirecionar uma conexão de entrada para um computador que não está ingressado em um farm no Agente de Sessão do TS.
Sua implementação de WTSSBX_GetUserExternalSession deverá retornar E_NOTIMPL se não der suporte ao redirecionamento para computadores que não ingressaram em farms no Agente de Sessão do TS.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | tssbx.h |