Partager via

GetAttribIMsgOnIStg

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Récupère les attributs des propriétés sur 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 GetAttribIMsgOnIStg(
  LPVOID lpObject,
  LPSPropTagArray lpPropTagArray,
  LPSPropAttrArray FAR * lppPropAttrArray
);

Paramètres

lpObject

[in] Pointeur vers un objet IMessage obtenu à partir de la fonction OpenIMsgOnIStg .

lpPropTagArray

[in] Pointeur vers une structure SPropTagArray qui contient un tableau de balises de propriété indiquant les propriétés pour lesquelles les attributs doivent être récupérés.

lppPropAttrArray

[out] Pointeur vers un pointeur vers la structure SPropAttrArray retournée qui contient les attributs de propriété récupérés.

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.

Remarque

GetAttribIMsgOnIStg 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.

Le nombre et les positions des attributs dans le paramètre lppPropAttrArray correspondent au nombre et aux positions des balises de propriété dans le paramètre lpPropTagArray .