ITnef::OpenTaggedBody
S’applique à : Outlook 2013 | Outlook 2016
Ouvre une interface de flux sur le texte d’un message encapsulé.
HRESULT OpenTaggedBody(
LPMESSAGE lpMessage,
ULONG ulFlags,
LPSTREAM FAR * lppStream
);
Paramètres
lpMessage
[in] Pointeur vers le message auquel le flux est associé. Ce message n’est pas obligatoirement le même message que celui passé dans l’appel à la fonction OpenTnefStream ou OpenTnefStreamEx .
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont l’interface de flux est ouverte. Les indicateurs suivants peuvent être définis :
MAPI_CREATE
Si aucune propriété n’existe dans le message actuel, elle doit être créée. Si la propriété existe, les données actuelles de la propriété doivent être remplacées par les données du flux TNEF (Encapsulation Format) Transport-Neutral. Lorsqu’une implémentation définit l’indicateur MAPI_CREATE, elle doit également définir l’indicateur MAPI_MODIFY.
MAPI_MODIFY
Demande l’autorisation de lecture/écriture. L’interface par défaut est en lecture seule. MAPI_MODIFY doit être défini chaque fois que MAPI_CREATE est défini.
lppStream
[out] Pointeur vers un objet de flux qui contient le texte de la propriété PR_BODY (PidTagBody) du message encapsulé passé et qui prend en charge l’interface IStream .
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la ou les valeurs attendues.
Remarques
Les fournisseurs de transport, les fournisseurs de magasins de messages et les passerelles appellent la méthode ITnef ::OpenTaggedBody pour ouvrir une interface de flux sur le texte d’un message encapsulé (autrement dit, sur un objet TNEF).
Dans le cadre de son traitement, OpenTaggedBody insère ou analyse les balises de pièce jointe qui indiquent la position des pièces jointes ou des objets OLE dans le texte du message. Les balises de pièce jointe sont au format suivant :
[[nom de la pièce jointe :ndans lenom du conteneur de pièces jointes]]
le nom de pièce jointe décrit l’objet attachment ; n est un nombre qui identifie la pièce jointe qui fait partie d’une séquence, incrémentant à partir de la valeur passée dans le paramètre lpKey de la fonction OpenTnefStream ou OpenTnefStreamEx ; et nom du conteneur de pièces jointes décrit le composant physique où réside l’objet attachment.
OpenTaggedBody lit le texte du message et insère une balise de pièce jointe partout où un objet pièce jointe apparaît à l’origine dans le texte. Le texte du message d’origine n’est pas modifié.
Lorsqu’un message comportant des balises est passé à un flux, les balises sont supprimées et les objets de pièce jointe sont déplacés à la position des balises dans le flux.