Partager via


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.