Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODDragItemIterator

Next

The Next method returns a reference to the next storage unit in the iteration sequence.

ODStorageUnit Next ();

return value

A reference to the next storage unit in the iteration sequence, or kODNULL if you have reached the last storage unit.

DISCUSSION

If your part calls this method before calling this drag-item iterator's First method to begin the iteration, then this method works the same as calling the First method.

Because storage units are guaranteed to be valid only as long as the iterator is valid, you should never cache a reference to the returned storage unit. This method does not increment the reference count of the returned storage unit.

EXCEPTIONS

kODErrIteratorOutOfSync

The list of drag items was modified while the iteration was in progress.