ITnef::EncodeRecips
Gilt für: Outlook 2013 | Outlook 2016
Codiert eine Ansicht für die Empfängertabelle einer Nachricht im TNEF-Datenstream (Transport-Neutral Encapsulation Format) für die Nachricht.
HRESULT EncodeRecips(
ULONG ulFlags,
LPMAPITABLE lpRecipientTable
);
Parameter
ulFlags
[in] Reserviert. NULL muss sein.
lpRecipientTable
[in] Ein Zeiger auf die Empfängertabelle, für die die Ansicht codiert ist. Der lpRecipientTable-Parameter kann NULL sein.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.
Hinweise
Transportanbieter, Nachrichtenspeicheranbieter und Gateways rufen die ITnef::EncodeRecips-Methode auf, um die TNEF-Codierung für eine bestimmte Empfängertabellenansicht auszuführen. Die TNEF-Codierung ist z. B. nützlich, wenn ein Anbieter oder Gateway einen bestimmten Spaltensatz, eine bestimmte Sortierreihenfolge oder eine Einschränkung für die Empfängertabelle erfordert.
Ein Anbieter oder Gateway übergibt die Tabellenansicht, die im lpRecipientTable-Parameter codiert werden soll. Die TNEF-Implementierung codiert die Empfängertabelle mit der angegebenen Sicht unter Verwendung des angegebenen Spaltensatzes, der Sortierreihenfolge, der Einschränkung und der Position. Wenn ein Anbieter oder Gateway NULL in lpRecipientTable übergibt, ruft TNEF die Empfängertabelle aus der Nachricht ab, die mithilfe der IMessage::GetRecipientTable-Methode codiert wird, und verarbeitet jede Zeile der Tabelle mithilfe der aktuellen Einstellungen der Tabelle in den TNEF-Stream.
Das Aufrufen von EncodeRecips mit NULL in lpRecipientTable codiert somit alle Nachrichtenempfänger und entspricht dem Aufrufen der ITnef::AddProps-Methode mit dem flag TNEF_PROP_INCLUDE im ulFlags-Parameter und der PR_MESSAGE_RECIPIENTS-Eigenschaft (PidTagMessageRecipients) im lpPropList-Parameter .
Beachten Sie, dass das Aufrufen von EncodeRecips nur dann erforderlich ist, wenn eine bestimmte Empfängertabellenansicht codiert werden muss. Ausländische Messaging-Systeme verfügen fast immer über Möglichkeiten für die Behandlung von Empfängerlisten, die leistungsfähig genug sind, um die allgemeinen Anforderungen der Codierung von Empfängerlisten zu erfüllen; daher benötigen diese Systeme zu diesem Zweck fast nie TNEF.