Download Sun Java System Messaging Server 6 2005Q1 MTA Developer`s

mtaEnqueueInfo
Syntax
int mtaEnqueueInfo(mta_nq_t *nq_ctx,
int
item_code, ...);
int mtaEnqueueInfo(mta_nq_t *nq_ctx,
Arguments
Arguments
Description
nq_ctx
An enqueue context created by mtaEnqueueStart().
item_code
An optional list of item codes. See the description section that follows for a list of
item codes. The list must be terminated with an integer argument with value 0.
Description
Information associated with an ongoing message enqueue operation may be
obtained with mtaEnqueueInfo(). The information to obtain is specified through the
use of item codes. Arguments to the item codes provide memory addresses
through which to return the requested data.
String pointers returned by mtaEnqueueInfo() are only valid during the life of the
enqueue context. Once the enqueue has been completed, the associated pointers
are no longer valid.
The following table lists the item codes for this routine, their additional arguments,
and gives a description of each.
Item Codes
Additional Arguments
Description
MTA_ALIAS_EXPAND
size_t *value
Return the setting of the alias expansion flag. Normally,
this flag has a nonzero value that indicates that alias
expansion should be done for all envelope recipient
addresses. When the flag has a value of zero, alias
expansion will not be performed. The value of the flag is
set with the mtaEnqueueStart() routine.
This item code must be followed by one additional
argument: the address of size_t to store the setting’s
value in.
190
Messaging Server 6 2005Q1 • MTA Developer’s Reference