Structure MapiFileDesc (mapi.h)
Une structure MapiFileDesc contient des informations sur un fichier contenant une pièce jointe de message stockée en tant que fichier temporaire. Ce fichier peut contenir un objet OLE statique, un objet OLE incorporé, un message incorporé et d’autres types de fichiers. Pour la prise en charge d’Unicode, utilisez la structure MapiFileDescW .
Syntaxe
typedef struct {
ULONG ulReserved;
ULONG flFlags;
ULONG nPosition;
LPSTR lpszPathName;
LPSTR lpszFileName;
LPVOID lpFileType;
} MapiFileDesc, *lpMapiFileDesc;
Membres
ulReserved
Réservés au; doit être égal à zéro.
flFlags
Masque de bits des indicateurs d’option. Les indicateurs suivants peuvent être définis.
Si aucun indicateur n’est défini, la pièce jointe est traitée comme un fichier de données.
nPosition
Entier utilisé pour indiquer où dans le texte du message pour afficher la pièce jointe. Les pièces jointes remplacent le caractère trouvé à une certaine position dans le texte du message. Autrement dit, les pièces jointes remplacent le caractère dans le champ de structure MapiMessageNoteText[nPosition]. La valeur -1 (0xFFFFFFFF) signifie que la position d’attachement n’est pas indiquée ; l’application cliente doit fournir à l’utilisateur un moyen d’accéder à la pièce jointe.
lpszPathName
Pointeur vers le chemin complet du fichier joint. Ce chemin doit inclure la lettre de lecteur de disque et le nom du répertoire.
lpszFileName
Pointeur vers le nom de fichier de pièce jointe vu par le destinataire, qui peut différer du nom de fichier dans le membre lpszPathName si des fichiers temporaires sont utilisés. Si le membre lpszFileName est vide ou NULL, le nom de fichier de lpszPathName est utilisé.
lpFileType
Pointeur vers le type de fichier de pièce jointe, qui peut être représenté avec une structure MapiFileTagExt . La valeur NULL indique un type de fichier inconnu ou un type de fichier déterminé par le système d’exploitation.
Remarques
MAPI simple fonctionne avec trois types de pièces jointes incorporées :
- Pièces jointes de fichiers de données
- Pièces jointes de fichier objet OLE modifiables
- Pièces jointes de fichiers objet OLE statiques
Les fichiers objet OLE sont des représentations de fichiers de flux d’objets OLE. L’application cliente peut recréer un objet OLE à partir du fichier en appelant la fonction OLE OleLoadFromStream avec un objet OLESTREAM qui lit le contenu du fichier. Si une pièce jointe OLE est incluse dans un message sortant, le flux d’objets OLE doit être écrit directement dans le fichier utilisé comme pièce jointe.
Lors de l’utilisation de la nPosition du membre MapiFileDesc, l’application cliente ne doit pas placer deux pièces jointes au même emplacement. Les applications clientes peuvent ne pas afficher les pièces jointes de fichiers à des emplacements au-delà de la fin du texte du message.
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | mapi.h |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour