located through the <CODE>po_message_iterator</CODE> function.
</DL>

</P>
<P>
<DL>
<DT><U>Function:</U> po_message_t <B>po_next_message</B> <I>(po_message_iterator_t <VAR>iterator</VAR>)</I>
<DD><A NAME="IDX853"></A>
The <CODE>po_next_message</CODE> function returns the next message from
<VAR>iterator</VAR> and advances the iterator.  It returns <CODE>NULL</CODE> when the
iterator has reached the end of its message list.
</DL>

</P>
<P>
The following functions returns details of a <CODE>po_message_t</CODE>