Reset the read point to the start of the message.
int mtaDequeueLineNext(mta_dq_t *dq_ctx);
Arguments |
Description |
---|---|
dq_ctx |
A dequeue context created by mtaDequeueStart(). |
Repositions the read point back to the start of the message.
After obtaining a message’s recipient list by repeated calls to mtaDequeueRecipientNext(), the read point into the underlying message file is positioned at the start of the actual message. Specifically, at the start of the message’s outermost header. Calling mtaDequeueLineNext() advances this read point, with each call moving it towards the end of the message. To reposition the read point back to the start of the message (that is, to the start of the message’s outermost header), call mtaDequeueRewind(). Use this call if a program needs to make a second pass through a message. For example, a program might scan a message’s content before actually processing it.
Return Values |
Description |
---|---|
0 |
Normal, successful completion. |
MTA_BADARGS |
A NULL value was supplied for the dq_ctx call argument, or an invalid dequeue context was supplied for dq_ctx. |
MTA_ORDER |
Call made out of sequence. The call was made either before the recipient list has been exhausted with mtaDequeueRecipientNext(), or after the message had been dequeued or deferred with mtaDequeueMessageFinish(). |
MTA_THREAD |
The MTA SDK detected simultaneous use of the dequeue context by two different threads. |
None