FullTrustProcessLauncher Class

Reference

Definition

Namespace:: Windows.ApplicationModel

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Activate the full-trust Win32 component of an application from a Universal Windows app component in the same application package.

public ref class FullTrustProcessLauncher abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.FullTrustAppContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FullTrustProcessLauncher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.FullTrustAppContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class FullTrustProcessLauncher

Public Class FullTrustProcessLauncher

Inheritance: Object Platform::Object IInspectable FullTrustProcessLauncher

Attributes: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Device family	Windows Desktop Extension SDK (introduced in 10.0.14393.0)
API contract	Windows.ApplicationModel.FullTrustAppContract (introduced in v1.0)
App capabilities	runFullTrust

Remarks

The methods in this class may only be called by packages that have the runFullTrust capability. See App capability declarations.

To use this class, we recommend that you add a Windows Application Packaging Project to your solution (Learn more). Then, in the package manifest of that project, add the windows.fullTrustProcess extension.

Here's an example.

<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:rescap=
"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
         xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10">
  ...
  <Capabilities>
    <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    …
    <Application>
      …
      <Extensions>
        <desktop:Extension Category="windows.fullTrustProcess" Executable="fulltrustprocess.exe">
          <desktop:FullTrustProcess>
            <desktop:ParameterGroup GroupId="SyncGroup" Parameters="/Sync"/>
            <desktop:ParameterGroup GroupId="OtherGroup" Parameters="/Other"/>
          </desktop:FullTrustProcess>
        </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Methods

LaunchFullTrustProcessForAppAsync(String, String)	Launch the full-trust process for the specified application ID, with parameters.
LaunchFullTrustProcessForAppAsync(String)	Launch the full-trust process for the specified application ID.
LaunchFullTrustProcessForAppWithArgumentsAsync(String, String)	Launch the full-trust process for the specified application ID with the specified command line parameters.
LaunchFullTrustProcessForCurrentAppAsync()	Launch the full-trust process for the current application ID.
LaunchFullTrustProcessForCurrentAppAsync(String)	Launch the full-trust process for the current application ID, with parameters.
LaunchFullTrustProcessForCurrentAppWithArgumentsAsync(String)	Launch the full-trust process with the specified command line parameters.

Applies to

Share via