Sun Java System Messaging Server 6 2005Q4 MTA Developer's Reference

MTA_ADR_STATUS

Return textual status messages for each envelope recipient address (that is, an active transport address) specified with any of these item codes: MTA_TO, MTA_CC, MTA_BCC, MTA_HDR_TO, MTA_HDR_CC, or MTA_HDR_BCC. When a recipient address is successfully processed, the value of the associated item_status field will be zero and item_smessage will be a pointer to a NULL terminated string containing the rewritten form of the address. When a recipient address fails to be processed successfully, the value of the associated item_status field will be non-zero and item_smessage will be a pointer to a NULL terminated error message string.

After calling mtaSend() with MTA_ADR_STATUS, call the mtaSendDispose() function to dispose of any dynamic memory allocated by mtaSend().

The item_address and item_length fields are ignored for this item code.