IWorkspace2::StartRemoteApplicationEx-Methode (workspaceruntime.h)

Artikel
03/06/2024

Wird nicht unterstützt.

Startet ein RemoteApp-Programm mit zusätzlichen Optionen und Features.

Syntax

HRESULT StartRemoteApplicationEx(
  [in] BSTR         bstrWorkspaceId,
  [in] BSTR         bstrRequestingAppId,
  [in] BSTR         bstrRequestingAppFamilyName,
  [in] VARIANT_BOOL bLaunchIntoImmersiveClient,
  [in] BSTR         bstrImmersiveClientActivationContext,
  [in] SAFEARRAY    *psaParams
);

Parameter

[in] bstrWorkspaceId

Eine Zeichenfolge, die die ID der Verbindung enthält, in der die Anwendung gestartet wird.

[in] bstrRequestingAppId

Eine Zeichenfolge, die die ID einer Anwendung enthält, die auf dem Remotedesktop gestartet werden soll.

[in] bstrRequestingAppFamilyName

Eine Zeichenfolge, die den Familiennamen der zu startenden Anwendung enthält.

[in] bLaunchIntoImmersiveClient

VARIANT_TRUE , damit die Remoteanwendung gestartet wird, als ob über den Webclient mithilfe des modernen Remotedesktopprotokolls darauf zugegriffen wurde. VARIANT_FALSE , um die Remoteanwendung mithilfe der klassischen Terminalservermethodik zu starten.

[in] bstrImmersiveClientActivationContext

Eine Zeichenfolge, die den Kontext für den spezifischen Remotedesktopclient enthält.

[in] psaParams

Ein Zeiger auf ein Array von BSTR-Werten , das Parameter enthält, die an die Arbeitsbereichslaufzeit übergeben werden sollen.

Für RDP-Verbindungen enthält dieser Parameter zwei Zeichenfolgen:

Serialisierte RDP-Datei
Befehlszeilenparameter für den Remotedesktopverbindungsclient

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

StartRemoteApplicationEx enthält eine Reihe neuer Features: Starten einer Drittanbieteranwendung beim ersten Starten des Remotedesktops, Behandeln mehrerer Remotedesktops und Starten mit der webbasierten Clientbenutzeroberfläche.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	workspaceruntime.h (Einschließen von Workspaceruntime.h)

Weitere Informationen

IWorkspace2

IWorkspace3

Freigeben über