IMessageRouter::GetMessageType

[This is preliminary documentation and subject to change.]

Called on router sinks to retrieve the passed MailMsg object's message type.

HRESULT GetMessageType(
   [in]  IMailMsgProperties        *pIMailMsg,
   [out] DWORD                     *pdwMessageType
);

pIMailMsg

A reference to the MailMsg object housing the message for which the queue is requesting a type.

pwMessageType

On return, this address contains the message type.

Return Values

Remarks

The Advanced Queue (AQ) maintains a separate queue for each message type. Once a message has been categorized, the AQ requests routing information from routing sinks. This information includes the message type, and the message's next hop.

The message type can be any DWORD value can be sink-application specific. The SMTP service provides only one default message type. Other applications can define new types, for example, those messages that need to be relayed using some mechanism other than SMTP, like X.500 or RPC.

See Also

IMailMsgProperties Interface