IWorkspace2::StartRemoteApplicationEx method

Not supported.

Starts a RemoteApp program with additional options and features.

Syntax

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

Parameters

bstrWorkspaceId

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

bstrRequestingAppId

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

bstrRequestingAppFamilyName

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

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.

bstrImmersiveClientActivationContext

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

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 destop first starts, handling multiple remote desktops, and launching with the web-based client UI.

Requirements

   
Windows version Windows 8 Windows Server 2012
Target Platform Windows
Header workspaceruntime.h (include Workspaceruntime.h)

See Also

IWorkspace2

IWorkspace3