Tools/WinSN5.0Ver.iso/NETSCAP.50/WIN1998.ZIP/ns/lib/plugin/nsplugin.h

C/C++ Source or Header | 1998-04-08 | 31.1 KB | 935 lines

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * The contents of this file are subject to the Netscape Public License
 * Version 1.0 (the "NPL"); you may not use this file except in
 * compliance with the NPL.  You may obtain a copy of the NPL at
 * http://www.mozilla.org/NPL/
 *
 * Software distributed under the NPL is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
 * for the specific language governing rights and limitations under the
 * NPL.
 *
 * The Initial Developer of this code under the NPL is Netscape
 * Communications Corporation.  Portions created by Netscape are
 * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
 * Reserved.
 */

////////////////////////////////////////////////////////////////////////////////
// INTERFACE TO NETSCAPE COMMUNICATOR PLUGINS (NEW C++ API).
//
// This superscedes the old plugin API (npapi.h, npupp.h), and
// eliminates the need for glue files: npunix.c, npwin.cpp and npmac.cpp.
// Correspondences to the old API are shown throughout the file.
////////////////////////////////////////////////////////////////////////////////

// XXX THIS HEADER IS A BETA VERSION OF THE NEW PLUGIN INTERFACE.
// USE ONLY FOR EXPERIMENTAL PURPOSES!

#ifndef nsplugin_h___
#define nsplugin_h___

#ifdef __OS2__
#pragma pack(1)
#endif

// XXX Move this XP_ defining stuff to xpcom or nspr...

#if defined (__OS2__ ) || defined (OS2)
#    ifndef XP_OS2
#        define XP_OS2 1
#    endif /* XP_OS2 */
#endif /* __OS2__ */

#ifdef _WINDOWS
#    ifndef XP_WIN
#        define XP_WIN 1
#    endif /* XP_WIN */
#endif /* _WINDOWS */

#ifdef __MWERKS__
#    define _declspec __declspec
#    ifdef macintosh
#        ifndef XP_MAC
#            define XP_MAC 1
#        endif /* XP_MAC */
#    endif /* macintosh */
#    ifdef __INTEL__
#        undef NULL
#        ifndef XP_WIN
#            define XP_WIN 1
#        endif /* __INTEL__ */
#    endif /* XP_PC */
#endif /* __MWERKS__ */

#ifdef XP_MAC
    #include <Quickdraw.h>
    #include <Events.h>
#endif

#ifdef XP_UNIX
    #include <X11/Xlib.h>
    #include <X11/Xutil.h>
#endif

#include "jri.h"                // XXX change to jni.h
#include "nsISupports.h"

////////////////////////////////////////////////////////////////////////////////

/* The OS/2 version of Netscape uses RC_DATA to define the
   mime types, file extentions, etc that are required.
   Use a vertical bar to seperate types, end types with \0.
   FileVersion and ProductVersion are 32bit ints, all other
   entries are strings the MUST be terminated wwith a \0.

AN EXAMPLE:

RCDATA NP_INFO_ProductVersion { 1,0,0,1,}

RCDATA NP_INFO_MIMEType    { "video/x-video|",
                             "video/x-flick\0" }
RCDATA NP_INFO_FileExtents { "avi|",
                             "flc\0" }
RCDATA NP_INFO_FileOpenName{ "MMOS2 video player(*.avi)|",
                             "MMOS2 Flc/Fli player(*.flc)\0" }

RCDATA NP_INFO_FileVersion       { 1,0,0,1 }
RCDATA NP_INFO_CompanyName       { "Netscape Communications\0" }
RCDATA NP_INFO_FileDescription   { "NPAVI32 Extension DLL\0"
RCDATA NP_INFO_InternalName      { "NPAVI32\0" )
RCDATA NP_INFO_LegalCopyright    { "Copyright Netscape Communications \251 1996\0"
RCDATA NP_INFO_OriginalFilename  { "NVAPI32.DLL" }
RCDATA NP_INFO_ProductName       { "NPAVI32 Dynamic Link Library\0" }

*/


/* RC_DATA types for version info - required */
#define NP_INFO_ProductVersion      1
#define NP_INFO_MIMEType            2
#define NP_INFO_FileOpenName        3
#define NP_INFO_FileExtents         4

/* RC_DATA types for version info - used if found */
#define NP_INFO_FileDescription     5
#define NP_INFO_ProductName         6

/* RC_DATA types for version info - optional */
#define NP_INFO_CompanyName         7
#define NP_INFO_FileVersion         8
#define NP_INFO_InternalName        9
#define NP_INFO_LegalCopyright      10
#define NP_INFO_OriginalFilename    11

#ifndef RC_INVOKED

////////////////////////////////////////////////////////////////////////////////
// Structures and definitions

#ifdef XP_MAC
#pragma options align=mac68k
#endif

typedef const char*     nsMIMEType;

struct nsByteRange {
    PRInt32             offset;     /* negative offset means from the end */
    PRUint32            length;
    struct nsByteRange* next;
};

struct nsRect {
    PRUint16            top;
    PRUint16            left;
    PRUint16            bottom;
    PRUint16            right;
};

////////////////////////////////////////////////////////////////////////////////
// Unix specific structures and definitions

#ifdef XP_UNIX

/*
 * Callback Structures.
 *
 * These are used to pass additional platform specific information.
 */
enum NPPluginCallbackType {
    NPPluginCallbackType_SetWindow = 1,
    NPPluginCallbackType_Print
};

struct NPPluginAnyCallbackStruct {
    PRInt32     type;
};

struct NPPluginSetWindowCallbackStruct {
    PRInt32     type;
    Display*    display;
    Visual*     visual;
    Colormap    colormap;
    PRUint32    depth;
};

struct NPPluginPrintCallbackStruct {
    PRInt32     type;
    FILE*       fp;
};

#endif /* XP_UNIX */

////////////////////////////////////////////////////////////////////////////////

// List of variable names for which NPP_GetValue shall be implemented
enum NPPluginVariable {
    NPPluginVariable_NameString = 1,
    NPPluginVariable_DescriptionString,
    NPPluginVariable_WindowBool,        // XXX go away
    NPPluginVariable_TransparentBool,   // XXX go away?
    NPPluginVariable_JavaClass,         // XXX go away
    NPPluginVariable_WindowSize
    // XXX add MIMEDescription (for unix) (but GetValue is on the instance, not the class)
};

// List of variable names for which NPN_GetValue is implemented by Mozilla
enum NPPluginManagerVariable {
    NPPluginManagerVariable_XDisplay = 1,
    NPPluginManagerVariable_XtAppContext,
    NPPluginManagerVariable_NetscapeWindow,
    NPPluginManagerVariable_JavascriptEnabledBool,      // XXX prefs accessor api
    NPPluginManagerVariable_ASDEnabledBool,             // XXX prefs accessor api
    NPPluginManagerVariable_IsOfflineBool               // XXX prefs accessor api
};

////////////////////////////////////////////////////////////////////////////////

enum NPPluginType {
    NPPluginType_Embedded = 1,
    NPPluginType_Full
};

// XXX this can go away now
enum NPStreamType {
    NPStreamType_Normal = 1,
    NPStreamType_Seek,
    NPStreamType_AsFile,
    NPStreamType_AsFileOnly
};

#define NP_STREAM_MAXREADY    (((unsigned)(~0)<<1)>>1)

/*
 * The type of a NPWindow - it specifies the type of the data structure
 * returned in the window field.
 */
enum NPPluginWindowType {
    NPPluginWindowType_Window = 1,
    NPPluginWindowType_Drawable
};

struct NPPluginWindow {
    void*       window;         /* Platform specific window handle */
                                /* OS/2: x - Position of bottom left corner  */
                                /* OS/2: y - relative to visible netscape window */
    PRUint32    x;              /* Position of top left corner relative */
    PRUint32    y;              /*    to a netscape page.                    */
    PRUint32    width;          /* Maximum window size */
    PRUint32    height;
    nsRect      clipRect;       /* Clipping rectangle in port coordinates */
                                /* Used by MAC only.              */
#ifdef XP_UNIX
    void*       ws_info;        /* Platform-dependent additonal data */
#endif /* XP_UNIX */
    NPPluginWindowType type;    /* Is this a window or a drawable? */
};

struct NPPluginFullPrint {
    PRBool      pluginPrinted;    /* Set TRUE if plugin handled fullscreen */
                                /*    printing                             */
    PRBool      printOne;       /* TRUE if plugin should print one copy  */
                                /*    to default printer                     */
    void*       platformPrint;  /* Platform-specific printing info */
};

struct NPPluginEmbedPrint {
    NPPluginWindow    window;
    void*       platformPrint;    /* Platform-specific printing info */
};

struct NPPluginPrint {
    NPPluginType      mode;     /* NP_FULL or NPPluginType_Embedded */
    union
    {
        NPPluginFullPrint     fullPrint;    /* if mode is NP_FULL */
        NPPluginEmbedPrint    embedPrint;    /* if mode is NPPluginType_Embedded */
    } print;
};

struct NPPluginEvent {

#if defined(XP_MAC)
    EventRecord* event;
    void*       window;

#elif defined(XP_WIN)
    uint16      event;
    uint32      wParam;
    uint32      lParam;

#elif defined(XP_OS2)
    uint32      event;
    uint32      wParam;
    uint32      lParam;

#elif defined(XP_UNIX)
    XEvent      event;

#endif
};

#ifdef XP_MAC
typedef RgnHandle nsRegion;
#elif defined(XP_WIN)
typedef HRGN nsRegion;
#elif defined(XP_UNIX)
typedef Region nsRegion;
#else
typedef void *nsRegion;
#endif /* XP_MAC */

////////////////////////////////////////////////////////////////////////////////
// Mac-specific structures and definitions.

#ifdef XP_MAC

struct NPPort {
    CGrafPtr    port;   /* Grafport */
    PRInt32     portx;  /* position inside the topmost window */
    PRInt32     porty;
};

/*
 *  Non-standard event types that can be passed to HandleEvent
 */
#define getFocusEvent           (osEvt + 16)
#define loseFocusEvent          (osEvt + 17)
#define adjustCursorEvent       (osEvt + 18)

#endif /* XP_MAC */

////////////////////////////////////////////////////////////////////////////////
// Error and Reason Code definitions

enum NPPluginError {
    NPPluginError_Base = 0,
    NPPluginError_NoError = 0,
    NPPluginError_GenericError,
    NPPluginError_InvalidInstanceError,
    NPPluginError_InvalidFunctableError,
    NPPluginError_ModuleLoadFailedError,
    NPPluginError_OutOfMemoryError,
    NPPluginError_InvalidPluginError,
    NPPluginError_InvalidPluginDirError,
    NPPluginError_IncompatibleVersionError,
    NPPluginError_InvalidParam,
    NPPluginError_InvalidUrl,
    NPPluginError_FileNotFound,
    NPPluginError_NoData,
    NPPluginError_StreamNotSeekable
};

enum NPPluginReason {
    NPPluginReason_Base = 0,
    NPPluginReason_Done = 0,
    NPPluginReason_NetworkErr,
    NPPluginReason_UserBreak,
    NPPluginReason_NoReason
};

////////////////////////////////////////////////////////////////////////////////
// Classes
////////////////////////////////////////////////////////////////////////////////

class NPIStream;                        // base class for all streams

// Classes that must be implemented by the plugin DLL:
class NPIPlugin;                        // plugin class (MIME-type handler)
class NPILiveConnectPlugin;             // subclass of NPIPlugin
class NPIPluginInstance;                // plugin instance
class NPIPluginStream;                  // stream to receive data from the browser

// Classes that are implemented by the browser:
class NPIPluginManager;                 // minimum browser requirements
class NPIPluginManagerStream;           // stream to send data to the browser
class NPIPluginInstancePeer;            // parts of NPIPluginInstance implemented by the browser
class NPILiveConnectPluginInstancePeer; // subclass of NPIPluginInstancePeer
class NPIPluginStreamPeer;              // parts of NPIPluginStream implemented by the browser
class NPISeekablePluginStreamPeer;      // seekable subclass of NPIPluginStreamPeer

//       Plugin DLL Side                Browser Side
//
//
//       +-----------+                 +-----------------------+
//       | Plugin /  |                 | Plugin Manager        |
//       | LC Plugin |                 |                       |
//       +-----------+                 +-----------------------+
//            ^                               ^
//            |                               |
//            |                        +-----------------------+
//            |                        | Plugin Manager Stream |
//            |                        +-----------------------+
//            |
//            |
//       +-----------------+   peer    +-----------------------+
//       | Plugin Instance |---------->| Plugin Instance Peer  |
//       |                 |           | / LC Plugin Inst Peer |
//       +-----------------+           +-----------------------+
//
//       +-----------------+   peer    +-----------------------+
//       | Plugin Stream   |---------->| Plugin Stream Peer /  |
//       |                 |           | Seekable P Stream Peer|
//       +-----------------+           +-----------------------+

////////////////////////////////////////////////////////////////////////////////
// This is the main entry point to the plugin's DLL. The plugin manager finds
// this symbol and calls it to create the plugin class. Once the plugin object
// is returned to the plugin manager, instances on the page are created by
// calling NPIPlugin::NewInstance.

// (Corresponds to NPP_Initialize.)
extern "C" NS_EXPORT NPPluginError
NP_CreatePlugin(NPIPluginManager* mgr, NPIPlugin* *result);

////////////////////////////////////////////////////////////////////////////////
// Plugin Stream Interface
// This base class is shared by both the plugin and the plugin manager.

class NPIStream : public nsISupports {
public:

    // The Release method on NPIPlugin corresponds to NPP_DestroyStream.

    // (Corresponds to NPP_WriteReady.)
    NS_IMETHOD_(PRInt32)
    WriteReady(void) = 0;

    // (Corresponds to NPP_Write and NPN_Write.)
    NS_IMETHOD_(PRInt32)
    Write(PRInt32 len, void* buffer) = 0;

};

#define NP_ISTREAM_IID                               \
{ /* 5d852ef0-a1bc-11d1-85b1-00805f0e4dfe */         \
    0x5d852ef0,                                      \
    0xa1bc,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// THINGS THAT MUST BE IMPLEMENTED BY THE PLUGIN...
////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////
// Plugin Interface
// This is the minimum interface plugin developers need to support in order to
// implement a plugin. The plugin manager may QueryInterface for more specific
// plugin types, e.g. NPILiveConnectPlugin.

class NPIPlugin : public nsISupports {
public:

    // The Release method on NPIPlugin corresponds to NPP_Shutdown.

    // The old NPP_New call has been factored into two plugin instance methods:
    //
    // NewInstance -- called once, after the plugin instance is created. This
    // method is used to initialize the new plugin instance (although the actual
    // plugin instance object will be created by the plugin manager).
    //
    // NPIPluginInstance::Start -- called when the plugin instance is to be
    // started. This happens in two circumstances: (1) after the plugin instance
    // is first initialized, and (2) after a plugin instance is returned to
    // (e.g. by going back in the window history) after previously being stopped
    // by the Stop method.

    NS_IMETHOD_(NPPluginError)
    NewInstance(NPIPluginInstancePeer* peer, NPIPluginInstance* *result) = 0;

#ifdef XP_UNIX  // XXX why can't this be XP?

    // (Corresponds to NPP_GetMIMEDescription.)
    NS_IMETHOD_(const char*)
    GetMIMEDescription(void) = 0;

#endif /* XP_UNIX */

};

#define NP_IPLUGIN_IID                               \
{ /* 8a623430-a1bc-11d1-85b1-00805f0e4dfe */         \
    0x8a623430,                                      \
    0xa1bc,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// LiveConnect Plugin Interface
// This interface defines additional entry points that a plugin developer needs
// to implement in order for the plugin to support LiveConnect, i.e. be
// scriptable by Java or JavaScript.

class NPILiveConnectPlugin : public NPIPlugin {
public:

    // (Corresponds to NPP_GetJavaClass.)
    NS_IMETHOD_(jclass)
    GetJavaClass(void) = 0;

};

#define NP_ILIVECONNECTPLUGIN_IID                    \
{ /* cf134df0-a1bc-11d1-85b1-00805f0e4dfe */         \
    0xcf134df0,                                      \
    0xa1bc,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// Plugin Instance Interface

// (Corresponds to NPP object.)
class NPIPluginInstance : public nsISupports {
public:

    // The Release method on NPIPluginInstance corresponds to NPP_Destroy.

    // See comment for NPIPlugin::NewInstance, above.
    NS_IMETHOD_(NPPluginError)
    Start(void) = 0;

    // The old NPP_Destroy call has been factored into two plugin instance
    // methods:
    //
    // Stop -- called when the plugin instance is to be stopped (e.g. by
    // displaying another plugin manager window, causing the page containing
    // the plugin to become removed from the display).
    //
    // Release -- called once, before the plugin instance peer is to be
    // destroyed. This method is used to destroy the plugin instance.

    NS_IMETHOD_(NPPluginError)
    Stop(void) = 0;

    // (Corresponds to NPP_SetWindow.)
    NS_IMETHOD_(NPPluginError)
    SetWindow(NPPluginWindow* window) = 0;

    // (Corresponds to NPP_NewStream.)
    NS_IMETHOD_(NPPluginError)
    NewStream(NPIPluginStreamPeer* peer, NPIPluginStream* *result) = 0;

    // (Corresponds to NPP_Print.)
    NS_IMETHOD_(void)
    Print(NPPluginPrint* platformPrint) = 0;

    // (Corresponds to NPP_HandleEvent.)
    // Note that for Unix and Mac the NPPluginEvent structure is different
    // from the old NPEvent structure -- it's no longer the native event
    // record, but is instead a struct. This was done for future extensibility,
    // and so that the Mac could receive the window argument too. For Windows
    // and OS2, it's always been a struct, so there's no change for them.
    NS_IMETHOD_(PRInt16)
    HandleEvent(NPPluginEvent* event) = 0;

    // (Corresponds to NPP_URLNotify.)
    NS_IMETHOD_(void)
    URLNotify(const char* url, const char* target,
              NPPluginReason reason, void* notifyData) = 0;

    // (Corresponds to NPP_GetValue.)
    NS_IMETHOD_(NPPluginError)
    GetValue(NPPluginVariable variable, void *value) = 0;

    // (Corresponds to NPP_SetValue.)
    NS_IMETHOD_(NPPluginError)
    SetValue(NPPluginManagerVariable variable, void *value) = 0;

};

#define NP_IPLUGININSTANCE_IID                       \
{ /* b62f3a10-a1bc-11d1-85b1-00805f0e4dfe */         \
    0xb62f3a10,                                      \
    0xa1bc,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// Plugin Stream Interface

class NPIPluginStream : public NPIStream {
public:

    // (Corresponds to NPP_NewStream's stype return parameter.)
    NS_IMETHOD_(NPStreamType)
    GetStreamType(void) = 0;

    // (Corresponds to NPP_StreamAsFile.)
    NS_IMETHOD_(void)
    AsFile(const char* fname) = 0;

};

#define NP_IPLUGINSTREAM_IID                         \
{ /* e7a97340-a1bc-11d1-85b1-00805f0e4dfe */         \
    0xe7a97340,                                      \
    0xa1bc,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// THINGS IMPLEMENTED BY THE BROWSER...
////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////
// Plugin Manager Interface
// This interface defines the minimum set of functionality that a plugin
// manager will support if it implements plugins. Plugin implementations can
// QueryInterface to determine if a plugin manager implements more specific
// APIs for the plugin to use.

class NPIPluginManager : public nsISupports {
public:

    // QueryInterface may be used to obtain a JRIEnv or JNIEnv
    // from an NPIPluginManager.
    // (Corresponds to NPN_GetJavaEnv.)

    // (Corresponds to NPN_ReloadPlugins.)
    NS_IMETHOD_(void)
    ReloadPlugins(PRBool reloadPages) = 0;

    // (Corresponds to NPN_MemAlloc.)
    NS_IMETHOD_(void*)
    MemAlloc(PRUint32 size) = 0;

    // (Corresponds to NPN_MemFree.)
    NS_IMETHOD_(void)
    MemFree(void* ptr) = 0;

    // (Corresponds to NPN_MemFlush.)
    NS_IMETHOD_(PRUint32)
    MemFlush(PRUint32 size) = 0;

};

#define NP_IPLUGINMANAGER_IID                        \
{ /* f10b9600-a1bc-11d1-85b1-00805f0e4dfe */         \
    0xf10b9600,                                      \
    0xa1bc,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

#define NP_IJRIENV_IID                               \
{ /* f9d4ea00-a1bc-11d1-85b1-00805f0e4dfe */         \
    0xf9d4ea00,                                      \
    0xa1bc,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

#define NP_IJNIENV_IID                               \
{ /* 04610650-a1bd-11d1-85b1-00805f0e4dfe */         \
    0x04610650,                                      \
    0xa1bd,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// Plugin Instance Peer Interface

class NPIPluginInstancePeer : public nsISupports {
public:

    NS_IMETHOD_(NPIPlugin*)
    GetClass(void) = 0;

    // (Corresponds to NPP_New's MIMEType argument.)
    NS_IMETHOD_(nsMIMEType)
    GetMIMEType(void) = 0;

    // (Corresponds to NPP_New's mode argument.)
    NS_IMETHOD_(NPPluginType)
    GetMode(void) = 0;

    // (Corresponds to NPP_New's argc argument.)
    NS_IMETHOD_(PRUint16)
    GetArgCount(void) = 0;

    // (Corresponds to NPP_New's argn argument.)
    NS_IMETHOD_(const char**)
    GetArgNames(void) = 0;

    // (Corresponds to NPP_New's argv argument.)
    NS_IMETHOD_(const char**)
    GetArgValues(void) = 0;

    NS_IMETHOD_(NPIPluginManager*)
    GetPluginManager(void) = 0;

    // (Corresponds to NPN_GetURL and NPN_GetURLNotify.)
    //   notifyData: When present, URLNotify is called passing the notifyData back
    //          to the client. When NULL, this call behaves like NPN_GetURL.
    // New arguments:
    //   altHost: An IP-address string that will be used instead of the host
    //          specified in the URL. This is used to prevent DNS-spoofing attacks.
    //          Can be defaulted to NULL meaning use the host in the URL.
    //   referrer:
    //   forceJSEnabled: Forces JavaScript to be enabled for 'javascript:' URLs,
    //          even if the user currently has JavaScript disabled.
    NS_IMETHOD_(NPPluginError)
    GetURL(const char* url, const char* target, void* notifyData = NULL,
           const char* altHost = NULL, const char* referrer = NULL,
           PRBool forceJSEnabled = PR_FALSE) = 0;

    // (Corresponds to NPN_PostURL and NPN_PostURLNotify.)
    //   notifyData: When present, URLNotify is called passing the notifyData back
    //          to the client. When NULL, this call behaves like NPN_GetURL.
    // New arguments:
    //   altHost: An IP-address string that will be used instead of the host
    //          specified in the URL. This is used to prevent DNS-spoofing attacks.
    //          Can be defaulted to NULL meaning use the host in the URL.
    //   referrer:
    //   forceJSEnabled: Forces JavaScript to be enabled for 'javascript:' URLs,
    //          even if the user currently has JavaScript disabled.
    //   postHeaders: A string containing post headers.
    //   postHeadersLength: The length of the post headers string.
    NS_IMETHOD_(NPPluginError)
    PostURL(const char* url, const char* target, PRUint32 bufLen,
            const char* buf, PRBool file, void* notifyData = NULL,
            const char* altHost = NULL, const char* referrer = NULL,
            PRBool forceJSEnabled = PR_FALSE,
            PRUint32 postHeadersLength = 0, const char* postHeaders = NULL) = 0;

    // (Corresponds to NPN_NewStream.)
    NS_IMETHOD_(NPPluginError)
    NewStream(nsMIMEType type, const char* target,
              NPIPluginManagerStream* *result) = 0;

    // (Corresponds to NPN_Status.)
    NS_IMETHOD_(void)
    ShowStatus(const char* message) = 0;

    // (Corresponds to NPN_UserAgent.)
    NS_IMETHOD_(const char*)
    UserAgent(void) = 0;

    // (Corresponds to NPN_GetValue.)
    NS_IMETHOD_(NPPluginError)
    GetValue(NPPluginManagerVariable variable, void *value) = 0;

    // (Corresponds to NPN_SetValue.)
    NS_IMETHOD_(NPPluginError)
    SetValue(NPPluginVariable variable, void *value) = 0;

    ////////////////////////////////////////////////////////////////////////////
    // XXX Only used by windowless plugin instances?...

    // (Corresponds to NPN_InvalidateRect.)
    NS_IMETHOD_(void)
    InvalidateRect(nsRect *invalidRect) = 0;

    // (Corresponds to NPN_InvalidateRegion.)
    NS_IMETHOD_(void)
    InvalidateRegion(nsRegion invalidRegion) = 0;

    // (Corresponds to NPN_ForceRedraw.)
    NS_IMETHOD_(void)
    ForceRedraw(void) = 0;

    // New top-level window handling calls for Mac:

    NS_IMETHOD_(void)
    RegisterWindow(void* window) = 0;

    NS_IMETHOD_(void)
    UnregisterWindow(void* window) = 0;

};

#define NP_IPLUGININSTANCEPEER_IID                   \
{ /* 15c75de0-a1bd-11d1-85b1-00805f0e4dfe */         \
    0x15c75de0,                                      \
    0xa1bd,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// LiveConnect Plugin Instance Peer Interface
// Browsers that support LiveConnect implement this subclass of plugin instance
// peer.

// XXX Should this really be a separate subclass?

class NPILiveConnectPluginInstancePeer : public NPIPluginInstancePeer {
public:

    // (Corresponds to NPN_GetJavaPeer.)
    NS_IMETHOD_(jobject)
    GetJavaPeer(void) = 0;

};

#define NP_ILIVECONNECTPLUGININSTANCEPEER_IID        \
{ /* 1e3502a0-a1bd-11d1-85b1-00805f0e4dfe */         \
    0x1e3502a0,                                      \
    0xa1bd,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// Plugin Manager Stream Interface

class NPIPluginManagerStream : public NPIStream {
public:

    // (Corresponds to NPStream's url field.)
    NS_IMETHOD_(const char*)
    GetURL(void) = 0;

    // (Corresponds to NPStream's end field.)
    NS_IMETHOD_(PRUint32)
    GetEnd(void) = 0;

    // (Corresponds to NPStream's lastmodified field.)
    NS_IMETHOD_(PRUint32)
    GetLastModified(void) = 0;

    // (Corresponds to NPStream's notifyData field.)
    NS_IMETHOD_(void*)
    GetNotifyData(void) = 0;

};

#define NP_IPLUGINMANAGERSTREAM_IID                  \
{ /* 30c24560-a1bd-11d1-85b1-00805f0e4dfe */         \
    0x30c24560,                                      \
    0xa1bd,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// Plugin Stream Peer Interface
// A plugin stream peer is passed to a plugin instance's NewStream call in
// order to indicate that a new stream is to be created and be read by the
// plugin instance.

class NPIPluginStreamPeer : public nsISupports {
public:

    // (Corresponds to NPP_DestroyStream's reason argument.)
    NS_IMETHOD_(NPPluginReason)
    GetReason(void) = 0;

    // (Corresponds to NPP_NewStream's MIMEType argument.)
    NS_IMETHOD_(nsMIMEType)
    GetMIMEType(void) = 0;

    NS_IMETHOD_(PRUint32)
    GetContentLength(void) = 0;
#if 0
    NS_IMETHOD_(const char*)
    GetContentEncoding(void) = 0;

    NS_IMETHOD_(const char*)
    GetCharSet(void) = 0;

    NS_IMETHOD_(const char*)
    GetBoundary(void) = 0;

    NS_IMETHOD_(const char*)
    GetContentName(void) = 0;

    NS_IMETHOD_(time_t)
    GetExpires(void) = 0;

    NS_IMETHOD_(time_t)
    GetLastModified(void) = 0;

    NS_IMETHOD_(time_t)
    GetServerDate(void) = 0;

    NS_IMETHOD_(NPServerStatus)
    GetServerStatus(void) = 0;
#endif
    NS_IMETHOD_(PRUint32)
    GetHeaderFieldCount(void) = 0;

    NS_IMETHOD_(const char*)
    GetHeaderFieldKey(PRUint32 index) = 0;

    NS_IMETHOD_(const char*)
    GetHeaderField(PRUint32 index) = 0;

};

#define NP_IPLUGINSTREAMPEER_IID                     \
{ /* 38278eb0-a1bd-11d1-85b1-00805f0e4dfe */         \
    0x38278eb0,                                      \
    0xa1bd,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}

////////////////////////////////////////////////////////////////////////////////
// Seekable Plugin Stream Peer Interface
// The browser implements this subclass of plugin stream peer if a stream
// is seekable. Plugins can query interface for this type, and call the
// RequestRead method to seek to a particular position in the stream.

class NPISeekablePluginStreamPeer : public NPIPluginStreamPeer {
public:

    // QueryInterface for this class corresponds to NPP_NewStream's
    // seekable argument.

    // (Corresponds to NPN_RequestRead.)
    NS_IMETHOD_(NPPluginError)
    RequestRead(nsByteRange* rangeList) = 0;

};

#define NP_ISEEKABLEPLUGINSTREAMPEER_IID             \
{ /* f55c8250-a73e-11d1-85b1-00805f0e4dfe */         \
    0xf55c8250,                                      \
    0xa73e,                                          \
    0x11d1,                                          \
    {0x85, 0xb1, 0x00, 0x80, 0x5f, 0x0e, 0x4d, 0xfe} \
}                                                    \

////////////////////////////////////////////////////////////////////////////////

#ifdef XP_MAC
#pragma options align=reset
#endif

#endif /* RC_INVOKED */
#ifdef __OS2__
#pragma pack()
#endif

#endif /* nsplugin_h___ */