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

[ L’interface IWTSSBPlugin n’est pas prise en charge après Windows Server 2008 R2. À compter de Windows Server 2012 utilisez l’interface ITsSbPlugin.]

Redirige une connexion entrante vers une ressource informatique, telle qu’une machine virtuelle, un serveur lame ou même le bureau d’entreprise de l’utilisateur en fournissant une structure WTSSBX_MACHINE_CONNECT_INFO qui contient des informations sur la ressource.

Syntaxe

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

Paramètres

[in] UserName

Pointeur vers une chaîne Unicode qui contient le nom d’utilisateur de la connexion entrante.

[in] DomainName

Pointeur vers une chaîne Unicode qui contient le nom de domaine de la connexion entrante.

[in] ApplicationType

Pointeur vers une chaîne Unicode qui contient le programme exécuté par les services Bureau à distance après la création de la session utilisateur.

[in] RedirectorInternalIP

Pointeur vers l’adresse IP interne du serveur hôte de session Bureau à distance qui a d’abord accepté la connexion.

[out] pSessionId

Pointeur vers l’ID de session de la session vers laquelle le plug-in redirige la connexion entrante.

[out] pMachineConnectInfo

Pointeur vers une structure WTSSBX_MACHINE_CONNECT_INFO qui contient des informations sur l’ordinateur vers lequel le plug-in dirige la connexion entrante.

Valeur retournée

Retourne S_OK en cas de réussite.

Remarques

Terminal Services Session Broker (TS Session Broker) appelle cette méthode afin que le plug-in puisse rediriger une connexion entrante vers un ordinateur qui n’est pas joint à une batterie de serveurs dans TS Session Broker.

Votre implémentation de WTSSBX_GetUserExternalSession doit retourner E_NOTIMPL si elle ne prend pas en charge la redirection vers des ordinateurs qui ne sont pas joints à des batteries de serveurs dans le répartiteur de sessions TS.

Configuration requise

Voir aussi

ITsSbPlugin

IWTSSBPlugin