Decode Context Queries (Sun Java System Messaging Server 6 2005Q4 MTA Developer's Reference)

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

Decode Context Queries

When mtaDecodeMessage() calls either a caller-supplied inspection or output routine, it passes to those routines a decode context. Through various SDK routine calls, this decode context may be queried to obtain information about the message part currently being processed.

The following table lists the informational message codes that can be obtained about a message part being processed, and gives a description of each, including the SDK routine used to obtain it.

Message Code	Description
`MTA_DECODE_CCHARSET`	The character set specified with the `CHARSET` parameter of the part’s `Content-type:` header line. If the part lacks a `CHARSET` specification, then the value `us-ascii` will be returned. Obtain with `mtaDecodeMessageInfoString()`.
`MTA_DECODE_CDISP`	Value of the `Content-disposition:` header line, less any optional parameters. Will be a zero length string if the part lacks a `Content-disposition:` header line. Obtain with `mtaDecodeMessageInfoString()`.
`MTA_DECODE_CDISP_PARAMS`	Parameter list to the `Content-disposition:` header line, if any. The parsed list is returned as a pointer to an option context. For further information, see `mtaDecodeMessageInfoParams()`.
`MTA_DECODE_CSUBTYPE`	The content subtype specified with the part’s `Content-type:` header line (for example, `plain` for `text/plain`, `gif` for `image/gif`). Defaults to `plain` when the part lacks a `Content-type:` header line. Obtain with `mtaDecodeMessageInfoString()`.
`MTA_DECODE_CTYPE`	The major content type specified with the part’s `Content-type:` header line (for example, `text` for `text/plain`, `image` for `image/gif`). Defaults to `text` when the part lacks a `Content-type:` header line. Obtain with `mtaDecodeMessageInfoString()`.
`MTA_DECODE_CTYPE_PARAMS`	Parameter list to the `Content-type:` header line, if any. The parsed list is returned as a pointer to an option context. For further information, see `mtaDecodeMessageInfoParams()`.
`MTA_DECODE_DTYPE`	Data type associated with this part. Obtain with `mtaDecodeMessageInfoInt()`.
`MTA_DECODE_PART_NUMBER`	Sequential part number for the current part. The first message part is part `0`, the second part is `1`, the third part is `2`, and so on. Obtain with `mtaDecodeMessageInfoInt()`.