IWorkspace2::StartRemoteApplicationEx method (workspaceruntime.h)

Article
02/22/2024

Not supported.

Starts a RemoteApp program with additional options and features.

Syntax

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

Parameters

[in] bstrWorkspaceId

A string that contains the ID of the connection in which to the start the application.

[in] bstrRequestingAppId

A string that contains the ID of an application to launch on the remote desktop.

[in] bstrRequestingAppFamilyName

A string that contains the family name of the application to launch.

[in] bLaunchIntoImmersiveClient

VARIANT_TRUE to make the remote application launch as though it were accessed via the web client, using the modern Remote Desktop protocol. VARIANT_FALSE to make the remote application launch using classic Terminal Server methodology.

[in] bstrImmersiveClientActivationContext

A string containing the context for the specific remote desktop client.

[in] psaParams

A pointer to an array of BSTR values that contains parameters to pass to the workspace runtime.

For RDP connections, this parameter contains two strings:

Serialized RDP file
Command line parameters for Remote Desktop Connection client

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

StartRemoteApplicationEx contains a number of new features: launching a 3rd party application when the remote desktop first starts, handling multiple remote desktops, and launching with the web-based client UI.

Requirements

Requirement	Value
Minimum supported client	Windows 8
Minimum supported server	Windows Server 2012
Target Platform	Windows
Header	workspaceruntime.h (include Workspaceruntime.h)