GetNavigation Method

Applies To

OAQ

Description

Returns the position of the message that will be retrieved.

Usage

int GetNavigation(void) const throw(OException)

Arguments

none

Remarks

Possible return values include:

· OAQ_DQ_FIRST_MSG (1) - Retrieves the first message that is available and matches the search criteria.

· OAQ_DQ_NEXT_MSG (3) (Default) - Retrieves the next message that is available and matches the search criteria.

· OAQ_DQ_NEXT_TRANS (2) - Skips the remainder of the current transaction group, if any, and retrieves the first message of the next transaction group. Used only if the message grouping is enabled for the queue.