Encoding Recipient Tables with TNEF

The encoding of a recipient table into the TNEF stream is rarely necessary since most messaging systems support recipient lists directly. In general, the recipient properties are transmitted in the message header. When inclusion of the recipient table is necessary, TNEF can encode the recipient table as a part of its usual processing. This is done during the initial phase of TNEF processing. The transport provider can include the message's recipient table by calling the ITnef::AddProps method with the PR_MESSAGE_RECIPIENTS property specified in the inclusion list. TNEF gets the recipient table from the message, queries the column set, and processes every row of the table into the TNEF stream.

An alternate method is available if the transport provider needs to modify the recipient table before it is encoded. The transport provider can construct the necessary table and then call the ITnef::EncodeRecips method. If NULL is passed in the lpRecipTable parameter, then the recipient table is taken directly from the message as described for ITnef::AddProps.