modules/plugin/base/public/nsILegacyPluginWrapperOS2.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /* ***** BEGIN LICENSE BLOCK *****
   3  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
   4  *
   5  * The contents of this file are subject to the Mozilla Public License Version
   6  * 1.1 (the "License"); you may not use this file except in compliance with
   7  * the License. You may obtain a copy of the License at
   8  * http://www.mozilla.org/MPL/
   9  *
  10  * Software distributed under the License is distributed on an "AS IS" basis,
  11  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  12  * for the specific language governing rights and limitations under the
  13  * License.
  14  *
  15  * The Original Code is the Mozilla.org code.
  16  *
  17  * The Initial Developer of the Original Code is
  18  * InnoTek Systemberatung GmbH.
  19  * Portions created by the Initial Developer are Copyright (C) 2003
  20  * the Initial Developer. All Rights Reserved.
  21  *
  22  * Contributor(s):
  23  *    InnoTek Systemberatung GmbH / Knut St. Osmundsen
  24  *
  25  * Alternatively, the contents of this file may be used under the terms of
  26  * either the GNU General Public License Version 2 or later (the "GPL"), or
  27  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  28  * in which case the provisions of the GPL or the LGPL are applicable instead
  29  * of those above. If you wish to allow use of your version of this file only
  30  * under the terms of either the GPL or the LGPL, and not to allow others to
  31  * use your version of this file under the terms of the MPL, indicate your
  32  * decision by deleting the provisions above and replace them with the notice
  33  * and other provisions required by the GPL or the LGPL. If you do not delete
  34  * the provisions above, a recipient may use your version of this file under
  35  * the terms of any one of the MPL, the GPL or the LGPL.
  36  *
  37  * ***** END LICENSE BLOCK ***** */
  38
  39 #include "nsISupports.idl"
  40 #include "nspluginroot.idl"
  41
  42 %{C++
  43 #include "nsplugindefs.h"
  44
  45 // {7c4f689b-8c2a-11d7-911e-0003ffba5169}
  46 #define NS_LEGACY_PLUGIN_WRAPPER_CID \
  47 { 0x7c4f689b, 0x8c2a, 0x11d7, { 0x91, 0x1e, 0x00, 0x03, 0xff, 0xba, 0x51, 0x69 } }
  48
  49 #define NS_LEGACY_PLUGIN_WRAPPER_CONTRACTID "@mozilla.org/plugin/legacypluginwrapper;1"
  50
  51 struct PRLibrary;
  52 %}
  53
  54 interface nsIServiceManagerObsolete;
  55 interface nsIPlugin;
  56
  57 [ptr] native PRLibraryPtr(PRLibrary);
  58
  59 [uuid(7c4f689b-8c2a-11d7-911e-0003ffba5169)]
  60 interface nsILegacyPluginWrapperOS2 : nsISupports
  61 {
  62     /**
  63      * PR_FindSymbol(,"NSGetFactory") + NSGetFactory().
  64      */
  65     void getFactory(in nsIServiceManagerObsolete aServMgr,
  66                     in REFNSIID aClass,
  67                     in string aClassName,
  68                     in string aContractID,
  69                     in PRLibraryPtr aLibrary,
  70                     out nsIPlugin aResult);
  71
  72     /**
  73      * Create a wrapper for the given interface if it's a legacy interface.
  74      * @returns NS_OK on success.
  75      * @returns NS_ERROR_NO_INTERFACE if aIID isn't supported. aOut is nsnull.
  76      * @returns NS_ERROR_FAILURE on other error. aOut undefined.
  77      * @param   aIID    Interface Identifier of aIn and aOut.
  78      * @param   aIn     Interface of type aIID which may be a legacy interface
  79      *                  requiring a wrapper.
  80      * @param   aOut    The native interface.
  81      *                  If aIn is a legacy interface, this will be a wrappre.
  82      *                  If aIn is not a legacy interface, this is aIn.
  83      * @remark  Typically used for the flash plugin.
  84      */
  85     void maybeWrap(in REFNSIID aIID, in nsISupports aIn, out nsISupports aOut);
  86 };
  87