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

IEdmFolder5 GetNextFolder( 
   IEdmPos5 poPosition
)

IEdmFolder5^ GetNextFolder( 
&   IEdmPos5^ poPosition
) 

Parameters

poPosition

IEdmPos5; position of next parent folder of this file

Return Value

Before calling this method the first time, you must populate poPosition with the interface to the position of the first parent folder, IEdmPos5. Call IEdmFile5::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.

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

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

See Return Codes for the complete list of potential success and error codes. The following are just a few examples:

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