This method is used to start a service or app, such as an email client, that handles a given protocol. The Uniform Resource Identifier (URI) contains the protocol for the default service or app, such as mailto://firstname.lastname@example.org.
Syntaxnavigator.msLaunchUri(uri, successCallback, noHandlerCallback);
- uri [in]
URL containing protocol of the document or resource to be displayed.
- successCallback [in, optional]
Function to be executed if the protocol handler is present.
- noHandlerCallback [in, optional]
Function to be executed if the protocol handler isn't present.
This method does not return a value.
There are no standards that apply here.
If a default protocol handler is available on the system that matches the URI, the successCallback is invoked, otherwise, the noHandlerCallback is called.
If the user's system does not have a program registered to handle a specific protocol, and a noHandlerCallback is provided, Windows Internet Explorer will invoke the noHandlerCallback. This enables developers to provide a custom fallback experience for the user. If a handler doesn't exist, and the developer doesn't provide a noHandlerCallback, then Internet Explorer displays a dialog that asks the user if they want to allow the action. If the user allows it, the user is then prompted to look in the Windows Store for an app to handle the protocol.
If multiple programs are registered on the system for the given protocol and no default has been chosen, Windows prompts the user to choose one.