Function GetNextFolder( _
   ByVal poPos As IEdmPos5 _
) As IEdmFolder5

IEdmFolder5 GetNextFolder( 
   IEdmPos5 poPos
)

IEdmFolder5^ GetNextFolder( 
&   IEdmPos5^ poPos
) 

Parameters

poPos

IEdmPos5; position of the next folder (see Remarks)

Return Value

Before calling this method the first time, you must populate poPos with the interface to the position of the first folder with this label, IEdmPos5. Call IEdmLabel5::GetFirstFolderPosition to obtain IEdmPos5.

After calling this method the first time, poPos is automatically incremented every time it is called. Call this method repeatedly to obtain the rest of the folders with this label.

Be sure to call IEdmPos5::IsNull before you call this method to ensure you have not reached the end of the enumeration.

If you only need the ID of the next folder with this label, call IEdmLabel5::GetNextFolderID instead of this method.

C++ programmers not using smart-pointer wrapper functions must release the returned interface, IEdmFile5. 

Return codes:

• S_OK: The method successfully executed.
• E_EDM_END_OF_LIST: You have gone past the end of the list.