Launcher.LaunchUriForResultsAsync Method
Definition
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.
Overloads
| LaunchUriForResultsAsync(Uri, LauncherOptions) |
Asynchronously starts the default app associated with the URI scheme name for the specified URI, using the specified options. |
| LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet) |
Asynchronously starts the default app associated with the URI scheme name for the specified URI, using the specified options and input data. |
LaunchUriForResultsAsync(Uri, LauncherOptions)
Asynchronously starts the default app associated with the URI scheme name for the specified URI, using the specified options.
public:
static IAsyncOperation<LaunchUriResult ^> ^ LaunchUriForResultsAsync(Uri ^ uri, LauncherOptions ^ options);/// [Windows.Foundation.Metadata.Overload("LaunchUriForResultsAsync")]
static IAsyncOperation<LaunchUriResult> LaunchUriForResultsAsync(Uri const& uri, LauncherOptions const& options);[Windows.Foundation.Metadata.Overload("LaunchUriForResultsAsync")]
public static IAsyncOperation<LaunchUriResult> LaunchUriForResultsAsync(System.Uri uri, LauncherOptions options);function launchUriForResultsAsync(uri, options)Public Shared Function LaunchUriForResultsAsync (uri As Uri, options As LauncherOptions) As IAsyncOperation(Of LaunchUriResult)Parameters
- options
- LauncherOptions
The launch options.
Returns
When this method completes, it returns the results of the launch.
- Attributes
Remarks
Unless you are calling this API from a Windows desktop application, this API must be called from within an ASTA thread (also known as the UI thread).
This API may also be called from a Windows desktop application.
Launching an app for results allows you to launch an app from another app and exchange data between the two.
When calling this method, the options parameter must contain a valid value for LauncherOptions.TargetApplicationPackageFamilyName.
When calling LaunchUriForResultsAsync to launch a UWP app, the OnActivated method in the app that's launched will be invoked on a background thread, not the UI thread. Developers should ensure that any UI updates or interactions are marshaled to the UI thread appropriately.
See also
Applies to
LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)
Asynchronously starts the default app associated with the URI scheme name for the specified URI, using the specified options and input data.
public:
static IAsyncOperation<LaunchUriResult ^> ^ LaunchUriForResultsAsync(Uri ^ uri, LauncherOptions ^ options, ValueSet ^ inputData);/// [Windows.Foundation.Metadata.Overload("LaunchUriForResultsWithDataAsync")]
static IAsyncOperation<LaunchUriResult> LaunchUriForResultsAsync(Uri const& uri, LauncherOptions const& options, ValueSet const& inputData);[Windows.Foundation.Metadata.Overload("LaunchUriForResultsWithDataAsync")]
public static IAsyncOperation<LaunchUriResult> LaunchUriForResultsAsync(System.Uri uri, LauncherOptions options, ValueSet inputData);function launchUriForResultsAsync(uri, options, inputData)Public Shared Function LaunchUriForResultsAsync (uri As Uri, options As LauncherOptions, inputData As ValueSet) As IAsyncOperation(Of LaunchUriResult)Parameters
- options
- LauncherOptions
The launch options.
- inputData
- ValueSet
The data to send to the launched app.
Returns
When this method completes, it returns the results of the launch.
- Attributes
Remarks
Unless you are calling this API from a Windows desktop application, this API must be called from within an ASTA thread (also known as the UI thread).
This API may also be called from a Windows desktop application.
Launching an app for results allows you to launch an app from another app and exchange data between the two.
When calling this method, the options parameter must contain a valid value for LauncherOptions.TargetApplicationPackageFamilyName.
When calling LaunchUriForResultsAsync to launch a UWP app, the OnActivated method in the app that's launched will be invoked on a background thread, not the UI thread. Developers should ensure that any UI updates or interactions are marshaled to the UI thread appropriately.