wpQueryOpenFolders - Remarks

OS/2 maintains a list of all open folders in the system. wpQueryOpenFolders provides access to this list.

The first time you call wpQueryOpenFolders specify QC_FIRST in ulOption. A pointer to the first open folder in the open folder list is returned in Object. On subsequent calls specify QC_NEXT in ulOption and the pointer to the previously returned folder in Object. A pointer to the next folder in the open folder list is returned. wpQueryOpenFolders returns NULL after the last folder in the list has been returned.

wpQueryOpenFolders returns the next open folder after the folder passed in Object, or a NULL if the folder passed in Object is the last folder in the open folder list.

If wpQueryOpenFolders is called with QC_NEXT in ulOption and a pointer to a closed folder in Object then a QC_FIRST operation is performed.

Note: Do not close the open views of a folder returned by the wpQueryOpenFolders method because this breaks the chain of open folders. If you close the last open view of a folder, the next call to wpQueryOpenFolders will return NULL, even though there are other open folders in the system.


[Back: wpQueryOpenFolders - Parameters]
[Next: wpQueryOpenFolders - Usage]