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

Confira também

ITsSbPlugin

IWTSSBPlugin