IWTSSBPlugin::WTSSBX_GetUserExternalSession-Methode (tssbx.h)
[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 |