IPropData::HrAddObjProps
S’applique à : Outlook 2013 | Outlook 2016
Ajoute une ou plusieurs propriétés de type PT_OBJECT à l’objet .
HRESULT HrAddObjProps(
LPSPropTagArray lpPropTagArray,
LPSPropProblemArray FAR * lppProblems
);
Paramètres
lpPropTagArray
[in] Pointeur vers un tableau de balises de propriété qui indiquent les propriétés à ajouter.
lppProblems
[in, out] En entrée, pointeur valide vers une structure SPropProblemArray , ou NULL. En sortie, pointeur vers un pointeur vers une structure qui contient des informations sur les propriétés qui n’ont pas pu être ajoutées, ou NULL. Un pointeur vers une structure de tableau de problèmes de propriété est retourné uniquement si un pointeur valide est passé.
Valeur renvoyée
S_OK
Les propriétés ont été ajoutées avec succès.
MAPI_E_INVALID_TYPE
Un type de propriété autre que PT_OBJECT a été passé dans le tableau vers lequel pointe le paramètre lpPropTagArray .
MAPI_E_NO_ACCESS
L’objet a été défini pour ne pas autoriser l’autorisation de lecture/écriture.
MAPI_W_PARTIAL_COMPLETION
Certaines propriétés, mais pas toutes, ont été ajoutées.
Remarques
La méthode IPropData ::HrAddObjProps ajoute une ou plusieurs propriétés de type PT_OBJECT à l’objet. HrAddObjProps fournit une alternative à la méthode IMAPIProp ::SetProps pour les propriétés d’objet, car les propriétés d’objet ne peuvent pas être créées en appelant SetProps. L’ajout d’une propriété d’objet entraîne l’inclusion de la balise de propriété dans la liste des balises de propriété retournées par la méthode IMAPIProp ::GetPropList .
Remarques pour les appelants
Si HrAddObjProps retourne MAPI_W_PARTIAL_COMPLETION et que vous avez défini lppProblems sur un pointeur valide, case activée la structure SPropProblemArray retournée pour déterminer les propriétés qui n’ont pas été ajoutées. En règle générale, le seul problème qui se produit est le manque de mémoire. Libérez la structure SPropProblemArray en appelant la fonction MAPIFreeBuffer lorsque vous en avez terminé.
Pour ajouter une propriété, l’objet cible doit disposer d’une autorisation de lecture/écriture. Si HrAddObjProps retourne MAPI_E_NO_ACCESS, vous ne pouvez pas ajouter de propriétés à l’objet, car il n’autorise pas la modification. Pour obtenir l’autorisation de lecture/écriture sur un objet avant d’appeler HrAddObjProps, appelez IPropData ::HrSetObjAccess et définissez le paramètre ulAccess sur IPROP_READWRITE.