ITnef::OpenTaggedBody
Gilt für: Outlook 2013 | Outlook 2016
Öffnet eine Datenstromschnittstelle für den Text einer gekapselten Nachricht.
HRESULT OpenTaggedBody(
LPMESSAGE lpMessage,
ULONG ulFlags,
LPSTREAM FAR * lppStream
);
Parameter
lpMessage
[in] Ein Zeiger auf die Nachricht, der der Stream zugeordnet ist. Diese Nachricht muss nicht dieselbe Nachricht sein, die im Aufruf der OpenTnefStream- oder OpenTnefStreamEx-Funktion übergeben wird.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie die Streamschnittstelle geöffnet wird. Die folgenden Flags können festgelegt werden:
MAPI_CREATE
Wenn in der aktuellen Nachricht keine Eigenschaft vorhanden ist, sollte sie erstellt werden. Wenn die Eigenschaft vorhanden ist, sollten die aktuellen Daten in der Eigenschaft durch die Daten aus dem Transport-Neutral Encapsulation Format (TNEF)-Stream ersetzt werden. Wenn eine Implementierung das MAPI_CREATE-Flag festlegt, sollte sie auch das MAPI_MODIFY-Flag festlegen.
MAPI_MODIFY
Fordert Lese-/Schreibberechtigungen an. Die Standardschnittstelle ist schreibgeschützt. MAPI_MODIFY muss immer dann festgelegt werden, wenn MAPI_CREATE festgelegt wird.
lppStream
[out] Ein Zeiger auf einen Zeiger auf ein Streamobjekt, das den Text aus der eigenschaft PR_BODY (PidTagBody) der übergebenen gekapselten Nachricht enthält und die IStream-Schnittstelle unterstützt.
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::OpenTaggedBody-Methode auf, um eine Streamschnittstelle für den Text einer gekapselten Nachricht (d. h. für ein TNEF-Objekt) zu öffnen.
Im Rahmen der Verarbeitung fügt OpenTaggedBody Anlagetags ein oder analysiert diese, die die Position von Anlagen oder OLE-Objekten im Nachrichtentext angeben. Die Anlagentags weisen das folgende Format auf:
[[Anlagenname:nimNamen des Anlagencontainers]]
attachment name beschreibt das Anlageobjekt; n ist eine Zahl, die die Anlage identifiziert, die Teil einer Sequenz ist, und erhöht sich von dem Wert, der im lpKey-Parameter der OpenTnefStream - oder OpenTnefStreamEx-Funktion übergeben wird. und der Name des Anlagencontainers beschreibt die physische Komponente, in der sich das Anlagenobjekt befindet.
OpenTaggedBody liest Nachrichtentext vor und fügt ein Anlagetag ein, wo ein Anlageobjekt ursprünglich im Text angezeigt wurde. Der ursprüngliche Nachrichtentext wird nicht geändert.
Wenn eine Nachricht mit Tags an einen Stream übergeben wird, werden die Tags entfernt, und die Anlagenobjekte werden an der Position der Tags im Stream verschoben.