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

Article
08/26/2023

[ 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

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	tssbx.h

Voir aussi

ITsSbPlugin

IWTSSBPlugin

Partager via