Usage of nsISimpleEnumerator Interface

 Called to enumerate through each cookie in the cookie list.
 The objects enumerated over are of type nsICookie

readonly attribute nsISimpleEnumerator enumerator

 An enumeration of active nsIDownloads

readonly attribute nsISimpleEnumerator activeDownloads

 An enumeration of all registered Install Items

readonly attribute nsISimpleEnumerator installLocations

 Get the collection of dependency nsIFile instances recorded during the
 FastLoad file write or read/update process, and checked during the read
 process to invalidate the FastLoad file if any dependencies are newer.

readonly attribute nsISimpleEnumerator dependencies

  Returns an enumeration of the elements in a directory. Each
  element in the enumeration is an nsIFile.

   @return NS_ERROR_FILE_NOT_DIRECTORY if the current nsIFile does
           not specify a directory.

readonly attribute nsISimpleEnumerator directoryEntries

 Get the enumerator for the selected files
 only works in the modeOpenMultiple mode

 @return Returns the files currently selected

readonly attribute nsISimpleEnumerator files

 Returns the requests contained directly in this group.
 Enumerator element type: nsIRequest.

readonly attribute nsISimpleEnumerator requests

 Called to enumerate through each login in the password-manager list
 The objects enumerated over are of type nsIPassword

readonly attribute nsISimpleEnumerator enumerator

 Called to enumerate through each rejected site in the password-manager list
 These are sites for which the user has indicated that he doesn't want passwords saved.
 The objects enumerated over are of type nsIPassword, although the only member of
 that object that is relevent is the host (the user and password members are ignored).

readonly attribute nsISimpleEnumerator rejectEnumerator

 Allows enumeration of all stored permissions
 @return an nsISimpleEnumerator interface that allows access to
         nsIPermission objects

readonly attribute nsISimpleEnumerator enumerator

 Get a nsISimpleEnumerator whose elements are nsIProperty objects.

readonly attribute nsISimpleEnumerator enumerator

 Called to obtain a enumerator for all the  documents stored in 
 session history. The enumerator object thus returned by this method
 can be traversed using nsISimpleEnumerator. 

 @note  To access individual history entries of the enumerator, perform the
        following steps:
        1) Call nsISHistory->GetSHistoryEnumerator() to obtain handle 
           the nsISimpleEnumerator object.
        2) Use nsISimpleEnumerator->GetNext() on the object returned
           by step #1 to obtain handle to the next object in the list. 
           The object returned by this step is of type nsISupports.
        3) Perform a QueryInterface on the object returned by step #2 
           to nsIHistoryEntry.
        4) Use nsIHistoryEntry to access properties of each history entry. 

 @see nsISimpleEnumerator
 @see nsIHistoryEntry
 @see QueryInterface()
 @see do_QueryInterface()

readonly attribute nsISimpleEnumerator SHistoryEnumerator

 enumerate the array

 @returns a new enumerator positioned at the start of the array
 @throws NS_ERROR_FAILURE if the array is empty (to make it easy
         to detect errors)

nsISimpleEnumerator enumerate()

 Enumerate all existing categories
 @param aCategory The category to be enumerated.
 @return a simple enumerator, each result QIs to
         nsISupportsCString.

nsISimpleEnumerator enumerateCategories()

 Enumerate the entries in a category.
 @param aCategory The category to be enumerated.
 @return a simple enumerator, each result QIs to
         nsISupportsCString.

nsISimpleEnumerator enumerateCategory(in string aCategory)

 Gets an enumerator for all hooks which have been added.
 @return nsISimpleEnumerator for nsIClipboardDragDropHooks

nsISimpleEnumerator getHookEnumerator()

 enumerateCIDs

 Enumerate the list of all registered CIDs.

 @return : enumerator for CIDs.  Elements of the enumeration can be QI'ed
           for the nsISupportsID interface.  From the nsISupportsID, you 
           can obtain the actual CID.

nsISimpleEnumerator enumerateCIDs()

 enumerateContractIDs

 Enumerate the list of all registered ContractIDs.

 @return : enumerator for ContractIDs. Elements of the enumeration can be 
           QI'ed for the nsISupportsCString interface.  From  the
           nsISupportsCString interface, you can obtain the actual 
           Contract ID string.

nsISimpleEnumerator enumerateContractIDs()

 getFiles

 Directory Service calls this when it gets a request for
 a prop and the requested type is nsISimpleEnumerator.

 @param prop         The symbolic name of the file list.

 @return             An enumerator for a list of file locations.
                     The elements in the enumeration are nsIFile
 @returnCode         NS_SUCCESS_AGGREGATE_RESULT if this result should be
                     aggregated with other "lower" providers.

nsISimpleEnumerator getFiles(in string prop)

 Retrieve a list of all handlers in the datastore.  This list is not
 guaranteed to be in any particular order, and callers should not assume
 it will remain in the same order in the future.

 @returns a list of all handlers in the datastore

nsISimpleEnumerator enumerate()

 Get the set of bookmarks with microsummaries.

 In the old RDF-based bookmarks datastore, bookmark IDs are nsIRDFResource
 objects.  In the new Places-based datastore, they are nsIURI objects.

 @returns an nsISimpleEnumerator enumeration of bookmark IDs

nsISimpleEnumerator getBookmarks()

 Retrieve a enumerator of microsummaries in the set.

 @returns an enumerator of nsIMicrosummary objects

nsISimpleEnumerator Enumerate()

 enumerateObservers

 Returns an enumeration of all registered listeners.

 @param aTopic   : The notification topic or subject.

nsISimpleEnumerator enumerateObservers(in string aTopic)

 get an enumeration of nsIPropertyElement objects,
 which are read-only (i.e. setting properties on the element will
 not make changes back into the source nsIPersistentProperties

nsISimpleEnumerator enumerate()

 Enumerate the items in the prefetch queue.  Each element in the
 enumeration is an nsIDOMLoadStatus.

 @param aIncludeNormalItems include normal prefetch items in the
        list.  This parameter is deprecated and must be TRUE,
        or NS_ERROR_INT_IMPLEMENTED will be thrown.
 @param aIncludeOfflineItems include items being fetched for offline
        use.  This parameter is deprecated and must be FALSE,
        or NS_ERROR_NOT_IMPLEMENTED will be thrown.

nsISimpleEnumerator enumerateQueue(in boolean aIncludeNormalItems, in boolean aIncludeOfflineItems)

 Retrieve the datasources in the composite data source.
 @return an nsISimpleEnumerator that will enumerate each
 of the datasources in the composite

nsISimpleEnumerator GetDataSources()

 Return an enumerator that can be used to enumerate the contents
 of the container in ascending order.

nsISimpleEnumerator GetElements()

 Get a cursor to iterate over all the arcs that point into a node.

 @return NS_OK unless a catastrophic error occurs. If the method
 returns NS_OK, you may assume that labels points to a valid (but
 possible empty) nsISimpleEnumerator object.

nsISimpleEnumerator ArcLabelsIn(in nsIRDFNode aNode)

 Get a cursor to iterate over all the arcs that originate in
 a resource.

 @return NS_OK unless a catastrophic error occurs. If the method
 returns NS_OK, you may assume that labels points to a valid (but
 possible empty) nsISimpleEnumerator object.

nsISimpleEnumerator ArcLabelsOut(in nsIRDFResource aSource)

 Returns the set of all commands defined for a given source.

nsISimpleEnumerator GetAllCmds(in nsIRDFResource aSource)

 Retrieve all of the resources that the data source currently
 refers to.

nsISimpleEnumerator GetAllResources()

 Find all RDF resources that point to a given node over the
 specified arc & truth value

 @return NS_OK unless a catastrophic error occurs. If the
 method returns NS_OK, you may assume that nsISimpleEnumerator points
 to a valid (but possibly empty) cursor.

nsISimpleEnumerator GetSources(in nsIRDFResource aProperty, in nsIRDFNode aTarget, in boolean aTruthValue)

 Find all children of that are related to the source by the given arc
 arc and truth value.

 @return NS_OK unless a catastrophic error occurs. If the
 method returns NS_OK, you may assume that nsISimpleEnumerator points
 to a valid (but possibly empty) cursor.

nsISimpleEnumerator GetTargets(in nsIRDFResource aSource, in nsIRDFResource aProperty, in boolean aTruthValue)

 get all override keys for a given string bundle

nsISimpleEnumerator enumerateKeysInBundle(in AUTF8String url)

 Return an enumerator which iterates over all windows of type aWindowType
 from the oldest window to the youngest.
 @param  aWindowType the returned enumerator will enumerate only
                     windows of this type. ("type" is the
                     |windowtype| attribute of the XML <window> element.)
                     If null, all windows will be enumerated.
 @return an enumerator of nsIDOMWindows

nsISimpleEnumerator getEnumerator(in wstring aWindowType)

 Identical to getEnumerator except:
 @return an enumerator of nsIXULWindows

nsISimpleEnumerator getXULWindowEnumerator(in wstring aWindowType)

 Return an enumerator which iterates over all windows of type aWindowType
 in their z (front-to-back) order. Note this interface makes
 no requirement that a window couldn't be revisited if windows
 are re-ordered while z-order enumerators are active.
 @param  aWindowType the returned enumerator will enumerate only
                     windows of this type. ("type" is the
                     |windowtype| attribute of the XML <window> element.)
                     If null, all windows will be enumerated.
 @param  aFrontToBack if true, the enumerator enumerates windows in order
                      from front to back. back to front if false.
 @return an enumerator of nsIDOMWindows

nsISimpleEnumerator getZOrderDOMWindowEnumerator(in wstring aWindowType, in boolean aFrontToBack)

 Identical to getZOrderDOMWindowEnumerator except:
 @return an enumerator of nsIXULWindows

nsISimpleEnumerator getZOrderXULWindowEnumerator(in wstring aWindowType, in boolean aFrontToBack)

 Get an iterator for currently open windows in the order they were opened,
      guaranteeing that each will be visited exactly once.
      @return an enumerator which will itself return nsISupports objects which
              can be QIed to an nsIDOMWindow

nsISimpleEnumerator getWindowEnumerator()

 Get the style overlays for a particular chrome URI.

 @param aURI  The URI being loaded
 @return      An enumerator of nsIURI for the overlays of this URI 

nsISimpleEnumerator getStyleOverlays(in nsIURI aURI)

 Get the XUL overlays for a particular chrome URI.

 @param aURI  The URI being loaded
 @return      An enumerator of nsIURI for the overlays of this URI 

nsISimpleEnumerator getXULOverlays(in nsIURI aURI)

 Generate the results of a query and return them in an enumerator. The
 enumerator must contain nsIXULTemplateResult objects. If there are no
 results, an empty enumerator must be returned.

 The datasource will be the same as the one passed to the earlier
 initializeForBuilding method. The context reference (aRef) is a reference
 point used when calculating results.

 The value of aQuery must be the result of a previous call to compileQuery
 from this query processor. This method may be called multiple times,
 typically with different values for aRef.

 @param aDatasource datasource for the data
 @param aRef context reference value used as a starting point
 @param aQuery the compiled query returned from query compilation

 @returns an enumerator of nsIXULTemplateResult objects as the results

 @throws NS_ERROR_INVALID_ARG if aQuery is invalid

nsISimpleEnumerator generateResults(in nsISupports aDatasource, in nsIXULTemplateResult aRef, in nsISupports aQuery)