DialApp DialApp DialApp DialApp Class

Definition

Represents a DIAL application running on a remote device.

public : sealed class DialApp : IDialApppublic sealed class DialApp : IDialAppPublic NotInheritable Class DialApp Implements IDialApp// You can use this class in JavaScript.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

Get an instance of this class by accessing the GetDialApp property.

Properties

AppName AppName AppName AppName

Gets the application's registered DIAL name.

public : PlatForm::String AppName { get; }public string AppName { get; }Public ReadOnly Property AppName As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The DIAL name.

Methods

GetAppStateAsync() GetAppStateAsync() GetAppStateAsync() GetAppStateAsync()

Gets the current status of the application on the remote device.

public : IAsyncOperation<DialAppStateDetails> GetAppStateAsync()public IAsyncOperation<DialAppStateDetails> GetAppStateAsync()Public Function GetAppStateAsync() As IAsyncOperation( Of DialAppStateDetails )// You can use this method in JavaScript.
Returns

RequestLaunchAsync(String) RequestLaunchAsync(String) RequestLaunchAsync(String) RequestLaunchAsync(String)

Initiates the launching of the app on the remote device. When this method is called, the DialDevice is paired if necessary, the user is prompted to allow access to the device, connection is established, app existence is validated on the device, and finally the application is launched with the provided argument.

public : IAsyncOperation<DialAppLaunchResult> RequestLaunchAsync(PlatForm::String appArgument)public IAsyncOperation<DialAppLaunchResult> RequestLaunchAsync(String appArgument)Public Function RequestLaunchAsync(appArgument As String) As IAsyncOperation( Of DialAppLaunchResult )// You can use this method in JavaScript.
Parameters
appArgument
PlatForm::String String String String

Optional.

Returns

Remarks

This method must be called from the UI thread or an exception will be thrown. To dispatch the call to the UI thread from another thread, you can use CoreDispatcher.RunAsync.

StopAsync() StopAsync() StopAsync() StopAsync()

Stops the app on the remote device, if the remote device supports this functionality.

public : IAsyncOperation<DialAppStopResult> StopAsync()public IAsyncOperation<DialAppStopResult> StopAsync()Public Function StopAsync() As IAsyncOperation( Of DialAppStopResult )// You can use this method in JavaScript.
Returns