Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsCollection_GetNext
> Function
> Purpose
> Get the next object in a collection.
> C Declaration
> tibems_status tibemsCollection_GetNext(
> tibemsCollection collection,
> collectionObj* object);
> COBOL Call
> CALL "tibemsCollection_GetNext"
> USING BY VALUE collection,
> BY REFERENCE obj,
> RETURNING tibems-status
> END-CALL.

> | collection has usage pointer.

> Parameters

> Parameter | Description
> collection | Get the next object in this collection.
> object | The function stores the next object in the collection in this location.

> Remarks
> This function gets the next object in a collection. If there are no more objects in the collection, tibemsCollection_GetNext returns TIBEMS_NOT_FOUND.
> The function tibemsCollection_GetFirst must be called before tibemsCollection_GetNext is called for the first time.
> Status Codes

> Status Code | Description
> TIBEMS_NOT_INITIALIZED | The collection has not been initialized with a call to tibemsCollection_GetFirst.
> TIBEMS_NOT_FOUND | There are no more objects in the collection.

Copyright © TIBCO Software Inc. All Rights Reserved