IMessage::OpenAttach
S’applique à : Outlook 2013 | Outlook 2016
Ouvre une pièce jointe.
HRESULT OpenAttach(
ULONG ulAttachmentNum,
LPCIID lpInterface,
ULONG ulFlags,
LPATTACH FAR * lppAttach
);
Paramètres
ulAttachmentNum
[in] Numéro d’index de la pièce jointe à ouvrir, tel qu’il est stocké dans la propriété PR_ATTACH_NUM (PidTagAttachNumber) de la pièce jointe. Ce numéro d’index identifie de manière unique la pièce jointe dans le message et est valide uniquement dans le contexte du message.
lpInterface
[in] Pointeur vers l’identificateur d’interface (IID) représentant l’interface à utiliser pour accéder à la pièce jointe. La transmission de la valeur NULL entraîne le retour de l’interface standard de la pièce jointe, ou IAttach.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont la pièce jointe est ouverte. Les indicateurs suivants peuvent être définis :
MAPI_BEST_ACCESS
Demande que la pièce jointe soit ouverte avec les autorisations réseau maximales autorisées pour l’utilisateur et l’accès maximal à l’application cliente. Par exemple, si le client dispose d’une autorisation de lecture/écriture, la pièce jointe doit être ouverte avec l’autorisation de lecture/écriture ; si le client dispose d’un accès en lecture seule, la pièce jointe doit être ouverte avec un accès en lecture seule.
MAPI_DEFERRED_ERRORS
Permet à OpenAttach de revenir correctement, éventuellement avant que la pièce jointe ne soit entièrement disponible pour le client appelant. Si la pièce jointe n’est pas disponible, un appel ultérieur peut entraîner une erreur.
MAPI_MODIFY
Demande l’autorisation de lecture/écriture. Par défaut, les pièces jointes sont ouvertes avec un accès en lecture seule, et les clients ne doivent pas travailler sur l’hypothèse que l’autorisation de lecture/écriture a été accordée.
lppAttach
[out] Pointeur vers un pointeur vers la pièce jointe ouverte.
Valeur renvoyée
S_OK
La pièce jointe a été ouverte avec succès.
Remarques
La méthode IMessage ::OpenAttach ouvre la pièce jointe d’un message.
Remarques pour les appelants
Pour ouvrir une pièce jointe, vous devez avoir accès à son numéro de pièce jointe ou à sa propriété PR_ATTACH_NUM . Appelez IMessage ::GetAttachmentTable pour récupérer la table des pièces jointes du message et localiser la ligne qui représente la pièce jointe à ouvrir. Pour plus d’informations, consultez Ouverture d’une pièce jointe .
N’essayez pas d’ouvrir une pièce jointe plusieurs fois ; les résultats ne sont pas définis et dépendent du fournisseur de la banque de messages.
Vous pouvez demander que la pièce jointe soit ouverte en mode lecture/écriture, au lieu du mode lecture seule par défaut. Toutefois, il incombe au fournisseur de magasin de messages de déterminer si la pièce jointe sera réellement ouverte en mode lecture/écriture. Vous pouvez essayer de modifier la pièce jointe, vous préparer à gérer un éventuel échec ou case activée le niveau d’accès accordé en récupérant la propriété PR_ACCESS_LEVEL (PidTagAccessLevel) de la pièce jointe, si elle est disponible.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| AttachmentsDlg.cpp utilisé pour |
CAttachmentsDlg ::OpenItemProp |
MFCMAPI utilise la méthode IMessage ::OpenAttach pour ouvrir des objets de pièce jointe, |