This interface provides a means for enumerating the contents of a directory.
 It is similar to nsISimpleEnumerator except the retrieved entries are QI'ed 
 to nsIFile, and there is a mechanism for closing the directory when the 
 enumeration is complete.
 
 @status UNDER_REVIEW
[scriptable, uuid(31f7f4ae-6916-4f2d-a81e-926a4e3022ee)]
interface nsIDirectoryEnumerator : nsISupports

Attributes

 Retrieves the next file in the sequence. The "nextFile" element is the 
 first element upon the first call. This attribute is null if there is no 
 next element.
readonly attribute nsIFile nextFile

Methods

 Closes the directory being enumerated, releasing the system resource.
 @throws NS_OK if the call succeeded and the directory was closed.
         NS_ERROR_FAILURE if the directory close failed. 
         It is safe to call this function many times.
void close()