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

Return Values

mtaDecodeMessageInfoString() always returns a value for the CHARSET parameter of the Content-type: header line. When the Content-type: header line is not present, it returns the MIME default value, us-ascii.

Upon normal, successful completion a pointer to the requested string is returned. In addition, if pointers were provided in the str and len call arguments, the address of the string and its length are returned.

In the event of an error, a NULL value is returned and mta_errno is set to indicate the error status code. The following table lists the error status codes, and gives a description of each.

Error Status Codes  

Description  

MTA_BADARGS

A NULL value was supplied for the dctx call argument, or an invalid decode context was supplied for dctx.

MTA_NOSUCHITEM

An invalid value was supplied for the item call argument.