IMAPISupport::ModifyStatusRow
S’applique à : Outlook 2013 | Outlook 2016
Modifie la table status en ajoutant une nouvelle ligne ou en modifiant une ligne existante.
HRESULT ModifyStatusRow(
ULONG cValues,
LPSPropValue lpColumnVals,
ULONG ulFlags
);
Paramètres
cValues
[in] Nombre de propriétés à inclure dans la ligne de table nouvelle ou modifiée status.
lpColumnVals
[in] Pointeur vers un tableau de valeurs de propriété qui décrivent les propriétés à inclure en tant que colonnes dans la ligne de table nouvelle ou modifiée status.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont les informations qui définissent la ligne de table status sont traitées. L’indicateur suivant peut être défini :
STATUSROW_UPDATE
Indique à MAPI de fusionner les propriétés incluses dans le tableau vers lequel pointe lpColumnVals avec une ligne de table status existante, plutôt que dans une nouvelle ligne.
Valeur renvoyée
S_OK
La table status a été correctement mise à jour.
Remarques
La méthode IMAPISupport ::ModifyStatusRow est implémentée pour tous les objets de prise en charge du fournisseur de services. Les fournisseurs de services appellent ModifyStatusRow au moment de l’ouverture de session pour ajouter une ligne à la table status et à d’autres moments pendant la session pour mettre à jour la ligne. ModifyStatusRow fournit à MAPI les informations nécessaires pour générer la table status.
Remarques pour les appelants
Définissez l’indicateur STATUSROW_UPDATE lorsque vous appelez ModifyStatusRow pour apporter des modifications aux propriétés de votre ligne de table status existante. Cela informe MAPI que seules les colonnes modifiées sont passées dans le paramètre lpColumnVals .
Les clients peuvent utiliser les informations de la table status pour accéder à votre objet status.
Pour obtenir la liste complète des colonnes que vous devez inclure dans votre ligne de table status, consultez Tables d’état.