IWorkspace::StartRemoteApplication method

Starts a RemoteApp program.

Syntax


HRESULT StartRemoteApplication(
  [in] BSTR            bstrWorkspaceId,
  [in] SAFEARRAY(BSTR) psaParams
);

Parameters

bstrWorkspaceId [in]

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

psaParams [in]

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

Calling the StartRemoteApplication method can result in a new connection.

When a custom client calls the StartRemoteApplication method, the workspace runtime verifies that the RDP file is properly signed. If the RDP file signature is not valid, the user is prompted for new credentials with which to validate the file.

Requirements

Minimum supported client

Windows 7

Minimum supported server

Windows Server 2008 R2

IDL

WorkspaceRuntime.idl

Type library

Wksprt.exe

IID

CLSID_Workspace is defined as 4F1DFCA6-3AAD-48E1-8406-4BC21A501D7C

IID_IWorkspace is defined as B922BBB8-4C55-4FEA-8496-BEB0B44285E5

See also

IWorkspace2
IWorkspace3
IWorkspace

 

 

Show: