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

Confira também

ITsSbPlugin

IWTSSBPlugin