IMessage::GetAttachmentTable
S’applique à : Outlook 2013 | Outlook 2016
Retourne la table des pièces jointes du message.
HRESULT GetAttachmentTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Paramètres
ulFlags
[in] Masque de bits des indicateurs liés à la création de la table. L’indicateur suivant peut être défini :
MAPI_UNICODE
Les colonnes de chaîne sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les colonnes de chaîne sont au format ANSI.
MAPI_DEFERRED_ERRORS
Permet à GetAttachmentTable de revenir correctement, éventuellement avant que la table ne soit entièrement disponible pour le client appelant. Si la table n’est pas disponible, un appel ultérieur à celle-ci peut entraîner une erreur.
lppTable
[out] Pointeur vers un pointeur vers la table des pièces jointes.
Valeur renvoyée
S_OK
La table de pièces jointes a été récupérée avec succès.
Remarques
La méthode IMessage ::GetAttachmentTable retourne un pointeur vers la table des pièces jointes du message, qui inclut des informations sur toutes les pièces jointes du message. Les clients peuvent accéder à une pièce jointe uniquement par le biais de la table des pièces jointes. En récupérant le numéro d’une pièce jointe, sa propriété PR_ATTACH_NUM (PidTagAttachNumber), un client peut utiliser plusieurs méthodes IMessage pour utiliser la pièce jointe.
Il y a une ligne pour chaque pièce jointe. Pour obtenir la liste complète des colonnes d’une table de pièces jointes, consultez Tables de pièces jointes.
Une pièce jointe n’apparaît généralement pas dans la table des pièces jointes tant que la pièce jointe et le message n’ont pas été enregistrés avec un appel à IMAPIProp ::SaveChanges. Les tables de pièces jointes sont dynamiques. Si un client crée une pièce jointe, supprime une pièce jointe existante ou modifie une ou plusieurs propriétés une fois que les appels SaveChanges ont été effectués sur la pièce jointe sur le message, la table des pièces jointes est mise à jour pour refléter les nouvelles informations.
Certaines tables de pièces jointes prennent en charge un large éventail de restrictions ; d’autres ne le font pas. La prise en charge des restrictions dépend de l’implémentation du fournisseur de magasin de messages.
Lorsqu’elles sont initialement ouvertes, les tables de pièces jointes ne sont pas nécessairement triées dans un ordre particulier.
La définition de l’indicateur MAPI_UNICODE dans le paramètre ulFlags affecte les appels suivants à la table des pièces jointes :
IMAPITable ::QueryColumns pour récupérer le jeu de colonnes.
IMAPITable ::QueryRows pour récupérer des lignes.
IMAPITable ::QuerySortOrder pour récupérer l’ordre de tri.
La définition de l’indicateur Unicode demande que les informations relatives aux colonnes de chaîne retournées par ces appels soient au format Unicode. Toutefois, étant donné que tous les fournisseurs de magasins de messages ne prennent pas en charge Unicode, la définition de cet indicateur n’est qu’une requête.