Partager via


Propriété canonique PidTagAttachMethod

S’applique à : Outlook 2013 | Outlook 2016

Contient une constante définie par MAPI qui représente la façon dont le contenu d’une pièce jointe est accessible.

Propriété Valeur
Propriétés associées :
PR_ATTACH_METHOD
Identificateur :
0x3705
Type de données :
PT_LONG
Domaine :
Pièce jointe de message

Remarques

Cette propriété peut avoir exactement l’une des valeurs suivantes :

NO_ATTACHMENT

La pièce jointe vient d’être créée.

ATTACH_BY_VALUE

La propriété PR_ATTACH_DATA_BIN (PidTagAttachDataBinary) contient les données de pièce jointe.

ATTACH_BY_REFERENCE

La propriété PR_ATTACH_PATHNAME (PidTagAttachPathname) ou PR_ATTACH_LONG_PATHNAME (PidTagAttachLongPathname) contient un chemin d’accès complet identifiant la pièce jointe aux destinataires ayant accès à un serveur de fichiers commun.

ATTACH_BY_REF_RESOLVE

La propriété PR_ATTACH_PATHNAME ou PR_ATTACH_LONG_PATHNAME contient un chemin complet identifiant la pièce jointe.

ATTACH_BY_REF_ONLY

La propriété PR_ATTACH_PATHNAME ou PR_ATTACH_LONG_PATHNAME contient un chemin complet identifiant la pièce jointe.

ATTACH_EMBEDDED_MSG

La propriété PR_ATTACH_DATA_OBJ (PidTagAttachDataObject) contient un objet incorporé qui prend en charge l’interface IMessage .

ATTACH_OLE

La pièce jointe est un objet OLE incorporé.

ATTACH_BY_WEBREFERENCE

Le contenu de la pièce jointe ne figure pas dans le message.

Une fois créés, tous les objets de pièce jointe ont une valeur PR_ATTACH_METHOD initiale de NO_ATTACHMENT.

Les applications clientes et les fournisseurs de services ne sont requis que pour prendre en charge la méthode de pièce jointe représentée par la valeur ATTACH_BY_VALUE . Les autres méthodes de pièce jointe sont facultatives. La banque de messages n’applique aucune cohérence entre la valeur de PR_ATTACH_METHOD et les valeurs des autres propriétés de pièce jointe.

Les noms UNC (Universal Naming Convention) sont recommandés pour les chemins complets, qui doivent être utilisés avec ATTACH_BY_REFERENCE et ATTACH_BY_REF_ONLY. Avec ATTACH_BY_REF_RESOLVE, un chemin absolu est plus rapide, car le spouleur MAPI convertit la pièce jointe en ATTACH_BY_VALUE.

Si ATTACH_BY_REFERENCE est défini, PR_ATTACH_DATA_BIN doit être vide. Une passerelle sortante peut transformer une pièce jointe ATTACH_BY_REFERENCE en pièce jointe ATTACH_BY_VALUE en copiant les données de la pièce jointe dans la propriété PR_ATTACH_DATA_BIN .

Si ATTACH_BY_REF_RESOLVE est défini, PR_ATTACH_DATA_BIN doit être vide. Lorsque le message contenant la pièce jointe ATTACH_BY_REF_RESOLVE est envoyé, le spouleur MAPI copie les données de la pièce jointe dans une pièce jointe ATTACH_BY_VALUE . Ce processus de résolution place les données de pièce jointe dans PR_ATTACH_DATA_BIN.

Si ATTACH_BY_REF_ONLY est défini, PR_ATTACH_DATA_BIN doit être vide et le système de messagerie ne résout jamais la référence de pièce jointe. Utilisez cette valeur lorsque vous souhaitez envoyer le lien, mais pas les données.

Lorsque l’objet OLE est au format OLE 2.0 IStorage , les données sont accessibles via PR_ATTACH_DATA_OBJ. Lorsque l’objet OLE est au format OLE 1.0 OLESTREAM , les données sont accessibles via PR_ATTACH_DATA_BIN en tant qu’IStream. Le type de l’encodage OLE peut être déterminé par la valeur PR_ATTACH_TAG (PidTagAttachTag).

Pour plus d’informations sur les interfaces et les formats OLE, consultez la référence du programmeur OLE.

Lorsque le PR_ATTACH_METHOD est ATTACH_BY_WEBREFERENCE, le contenu de la pièce jointe ne figure pas dans le message. Au lieu de cela, la propriété PR_ATTACH_LONG_FILENAME contient une URL absolue vers le contenu de la pièce jointe, qui est stockée en ligne.

Spécifications du protocole

[MS-OXCMSG]

Gère les objets de message et de pièce jointe.

Fichiers d’en-tête

Mapidefs.h

Fournit des définitions de type de données.

Mapitags.h

Contient des définitions de propriétés répertoriées en tant que noms alternatifs.

Voir aussi

Propriété canonique PidTagStoreSupportMask

Propriétés MAPI

Propriétés canoniques MAPI

Mappage des noms de propriétés canoniques aux noms MAPI

Mappage des noms MAPI aux noms de propriétés canoniques