SetAttribIMsgOnIStg
S’applique à : Outlook 2013 | Outlook 2016
Définit ou modifie les attributs des propriétés d’un objet IMessage fourni par la fonction OpenIMsgOnIStg .
Propriété | Valeur |
---|---|
Fichier d’en-tête : |
Imessage.h |
Implémenté par : |
MAPI |
Appelé par : |
Applications clientes et fournisseurs de magasins de messages |
HRESULT SetAttribIMsgOnIStg(
LPVOID lpObject,
LPSPropTagArray lpPropTags,
LPSPropAttrArray lpPropAttrs,
LPSPropProblemArray FAR * lppPropProblems
);
Paramètres
lpObject
[in] Pointeur vers l’objet pour lequel les attributs de propriété sont définis.
lpPropTags
[in] Pointeur vers une structure SPropTagArray contenant un tableau de balises de propriété indiquant les propriétés pour lesquelles les attributs de propriété sont définis.
lpPropAttrs
[in] Pointeur vers une structure SPropAttrArray répertoriant les attributs de propriété à définir.
lppPropProblems
[out] Pointeur vers la structure SPropProblemArray retournée contenant un ensemble de problèmes de propriété. Cette structure identifie les problèmes rencontrés si SetAttribIMsgOnIStg a pu définir certaines propriétés, mais pas toutes. Si un pointeur vers NULL est passé dans le paramètre lppPropProblems , aucun tableau de problèmes de propriété n’est retourné même si certaines propriétés n’ont pas été définies.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_W_ERRORS_RETURNED
L’appel a réussi dans l’ensemble, mais une ou plusieurs propriétés n’ont pas pu être consultées et ont été retournées avec un type de propriété de PT_ERROR.
Remarques
Les attributs de propriété sont accessibles uniquement sur les objets de propriété, c’est-à-dire les objets implémentant l’interface IMAPIProp : IUnknown . Pour rendre les propriétés MAPI disponibles sur un objet de stockage structuré OLE, OpenIMsgOnIStg génère un objet IMessage : IMAPIProp sur l’objet OLE IStorage . Les attributs de propriété sur ces objets peuvent être définis ou modifiés avec SetAttribIMsgOnIStg et récupérés avec GetAttribIMsgOnIStg.
RemarqueGetAttribIMsgOnIStg et SetAttribIMsgOnIStg ne fonctionnent pas sur tous les objets IMessage . Elles ne sont valides que pour les objets IMessage-on-IStorage retournés par OpenIMsgOnIStg.
Dans le paramètre lpPropAttrs , le nombre et la position des attributs doivent correspondre au nombre et à la position des balises de propriété passées dans le paramètre lpPropTags .
La fonction SetAttribIMsgOnIStg permet de rendre les propriétés de message en lecture seule lorsque le schéma IMessage l’exige. L’exemple de fournisseur de magasin de messages l’utilise à cet effet. Pour plus d’informations, consultez Messages.