Freigeben über

IWTSSBPlugin::WTSSBX_GetUserExternalSession-Methode (tssbx.h)

  • Artikel

[Die IWTSSBPlugin-Schnittstelle wird nach Windows Server 2008 R2 nicht unterstützt. Ab Windows Server 2012 verwenden Sie bitte die ITsSbPlugin-Schnittstelle.]

Leitet eine eingehende Verbindung an eine Computerressource um, z. B. einen virtuellen Computer, einen Blattserver oder sogar den eigenen Unternehmensdesktop des Benutzers, indem eine WTSSBX_MACHINE_CONNECT_INFO-Struktur bereitgestellt wird , die Informationen zur Ressource enthält.

Syntax

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

Parameter

[in] UserName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Benutzernamen der eingehenden Verbindung enthält.

[in] DomainName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Domänennamen der eingehenden Verbindung enthält.

[in] ApplicationType

Ein Zeiger auf eine Unicode-Zeichenfolge, die das Programm enthält, das remotedesktopdienste ausgeführt wird, nachdem die Benutzersitzung erstellt wurde.

[in] RedirectorInternalIP

Ein Zeiger auf die interne IP-Adresse des RD-Sitzungshostservers, der die Verbindung zuerst akzeptiert hat.

[out] pSessionId

Ein Zeiger auf die Sitzungs-ID der Sitzung, an die das Plug-In die eingehende Verbindung umleitet.

[out] pMachineConnectInfo

Ein Zeiger auf eine WTSSBX_MACHINE_CONNECT_INFO Struktur, die Informationen über den Computer enthält, an den das Plug-In die eingehende Verbindung leitet.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück.

Hinweise

Der Terminaldienste-Sitzungsbroker (TS-Sitzungsbroker) ruft diese Methode auf, damit das Plug-In eine eingehende Verbindung zu einem Computer umleiten kann, der nicht mit einer Farm im TS-Sitzungsbroker verknüpft ist.

Ihre Implementierung von WTSSBX_GetUserExternalSession sollte E_NOTIMPL zurückgeben, wenn sie keine Umleitung zu Computern unterstützt, die nicht mit Farmen im TS-Sitzungsbroker verknüpft sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile tssbx.h

Weitere Informationen

ITsSbPlugin

IWTSSBPlugin