IWorkspace2::StartRemoteApplicationEx method (workspaceruntime.h)
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) |