michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #include "nsIMIMEInfo.idl"
michael@0: 
michael@0: /**
michael@0:  * The external URL handler service is used for finding
michael@0:  * platform-specific applications for handling particular URLs.
michael@0:  */
michael@0: 
michael@0: [scriptable, uuid(56c5c7d3-6fd3-43f8-9429-4397e111453a)]
michael@0: interface nsIExternalURLHandlerService : nsISupports
michael@0: {
michael@0:   /**
michael@0:    * Given a URL, looks up the handler info from the OS. This should be
michael@0:    * overridden by each OS's implementation.
michael@0:    *
michael@0:    * @param aURL The URL we are looking for.
michael@0:    * @param aFound  Was an OS default handler for this URL found?
michael@0:    * @return  An nsIHanderInfo for the protocol.
michael@0:    */
michael@0:   nsIHandlerInfo getURLHandlerInfoFromOS(in nsIURI aURL,
michael@0:                                          out boolean aFound);
michael@0: 
michael@0: };