nsIEventQueueService in Firefox 1.5

 Creates and hold a monitored event queue for the current thread.
 "Monitored" queues have no callback processing mechanism.
 @return NS_OK on success, or a host of failure indications

 Creates and holds a native event queue for the current thread.
 "Native" queues have an associated callback mechanism which is
 automatically triggered when an event is posted. See plevent.c for 
 details.
 @return NS_OK on success, or a host of failure indications

 Somewhat misnamed, this method releases the service's hold on the event
 queue(s) for this thread. Subsequent attempts to access this thread's
 queue (GetThreadEventQueue, for example) may fail, though the queue itself
 will be destroyed only after all references to it are released and the
 queue itself is no longer actively processing events.
 @return nonsense.

 Returns the appropriate special event queue, AddRef()ed.  Really
 just a scriptable version of ResolveEventQueue.

 @arg aQueue    Either CURRENT_THREAD_EVENT_QUEUE or
                UI_THREAD_EVENT_QUEUE
 @return        The requested nsIEventQueue, AddRef()ed
 @exception NS_ERROR_NULL_POINTER   Zero pointer passed in for return value
 @exception NS_ERROR_ILLEGAL_VALUE  Bogus constant passed in aQueue
 @exception NS_ERROR_FAILURE        Error while calling 
                                    GetThreadEventQueue()

 @deprecated in favor of getSpecialEventQueue, since that's
 scriptable and this isn't.

 Check for any "magic" event queue constants (NS_CURRENT_EVENTQ,
 NS_UI_THREAD_EVENTQ) and return the real event queue that they
 represent, AddRef()ed.  Otherwise, return the event queue passed
 in, AddRef()ed.  This is not scriptable because the arguments in
 question may be magic constants rather than real nsIEventQueues.

 @arg queueOrConstant    either a real event queue or a magic
                         constant to be resolved

 @return                 a real event queue, AddRef()ed