Launcher.LaunchUriAsync Method (Uri, LauncherOptions)

Starts the default app associated with the URI scheme name for the specified URI, using the specified options.

Syntax

public:
static IAsyncOperation<bool>^ LaunchUriAsync(
         Uri^ uri,
         LauncherOptions^ options
)

Parameters

uri
Type: Uri

The URI.

options
Type: LauncherOptions

The launch options for the app.

Return value

Type: IAsyncOperation<Boolean>

The launch operation.

Remarks

The calling app must be visible to the user when the API is invoked.

You must specify the privateNetworkClientServer capability in the manifest in order to launch intranet URIs, for example a file:/// URI pointing to a network location.

You cannot use this method to launch a URI in the local zone. For example, apps cannot use the file:/// protocol to access files on the local computer. Instead, you must use the Storage APIs to access files.

When the launch fails for any of the above reasons, the API will succeed and return FALSE from its asynchronous operation.

To enable the user to choose an app instead of launching the default app, set the LauncherOptions.DisplayApplicationPicker | displayApplicationPicker property.

To display a warning that the URI is potentially unsafe, set the LauncherOptions.TreatAsUntrusted | treatAsUntrusted property.

The URI is passed to the associated app. If the associated app is a desktop app, the URI is passed using shell execution mechanisms.

This API is not implemented and will throw an exception if called.

Requirements

Namespace: Windows.System

Metadata: windows.winmd