IMessage::CreateAttach
S’applique à : Outlook 2013 | Outlook 2016
Crée une pièce jointe.
HRESULT CreateAttach(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulAttachmentNum,
LPATTACH FAR * lppAttach
);
Paramètres
lpInterface
[in] Pointeur vers l’identificateur d’interface (IID) représentant l’interface à utiliser pour accéder au message. La transmission de la valeur NULL entraîne le retour de l’interface standard du message, ou IMessage.
ulFlags
[in] Masque de bits des indicateurs qui contrôle la façon dont la pièce jointe est créée. L’indicateur suivant peut être défini :
MAPI_DEFERRED_ERRORS
Permet à CreateAttach de revenir correctement, éventuellement avant que la pièce jointe ne soit entièrement accessible au client appelant. Si la pièce jointe n’est pas accessible, un appel ultérieur peut entraîner une erreur.
lpulAttachmentNum
[out] Pointeur vers un numéro d’index identifiant la pièce jointe nouvellement créée. Ce nombre est valide uniquement lorsque le message est ouvert et constitue la base de la propriété PR_ATTACH_NUM (PidTagAttachNumber) de la pièce jointe.
lppAttach
[out] Pointeur vers un pointeur vers l’objet pièce jointe ouvert.
Valeur renvoyée
S_OK
La pièce jointe a été créée avec succès.
Remarques
La méthode IMessage ::CreateAttach crée une pièce jointe sur un message. La nouvelle pièce jointe et toutes les propriétés qui lui sont définies ne sont pas disponibles tant qu’un client n’a pas appelé la méthode IMAPIProp ::SaveChanges de la pièce jointe et la méthode IMAPIProp ::SaveChanges du message.
Le numéro de pièce jointe pointé par lpulAttachmentNum est unique et valide uniquement dans le contexte du message. Autrement dit, deux pièces jointes dans deux messages différents peuvent avoir le même nombre, tandis que deux pièces jointes dans le même message ne le peuvent pas.