IMAPIFolder::SetMessageStatus
S’applique à : Outlook 2013 | Outlook 2016
Définit la status associée à un message (par exemple, si ce message est marqué pour suppression).
HRESULT SetMessageStatus(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulNewStatus,
ULONG ulNewStatusMask,
ULONG FAR * lpulOldStatus
);
Paramètres
cbEntryID
[in] Nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lpEntryID .
lpEntryID
[in] Pointeur vers l’identificateur d’entrée du message dont le status est défini.
ulNewStatus
[in] Nouveau status à affecter.
ulNewStatusMask
[in] Masque de bits d’indicateurs qui est appliqué au nouveau status et indique les indicateurs à définir. Les indicateurs suivants peuvent être définis :
MSGSTATUS_DELMARKED
Le message a été marqué pour suppression.
MSGSTATUS_HIDDEN
Le message ne doit pas s’afficher.
MSGSTATUS_HIGHLIGHTED
Le message doit être affiché en surbrillance.
MSGSTATUS_REMOTE_DELETE
Le message a été marqué pour suppression dans la banque de messages distante sans téléchargement sur le client local.
MSGSTATUS_REMOTE_DOWNLOAD
Le message a été marqué pour téléchargement à partir du magasin de messages distant vers le client local.
MSGSTATUS_TAGGED
Le message a été étiqueté dans un but défini par le client.
lpulOldStatus
[out] Pointeur vers la status précédente du message.
Valeur renvoyée
S_OK
Le message status a été correctement défini.
Remarques
La méthode IMAPIFolder ::SetMessageStatus définit le message status sur la valeur stockée dans sa propriété PR_MSG_STATUS (PidTagMessageStatus).
Remarques pour les responsables de l’implémentation
La façon dont le message status bits sont définis, effacés et utilisés dépend entièrement de votre implémentation, sauf que les bits 0 à 15 sont réservés et doivent être zéro.
L’implémentation de cette méthode par un fournisseur de transport distant doit suivre la sémantique décrite ici. Il n’y a pas de considérations particulières. Les clients utilisent cette méthode pour définir les bits MSGSTATUS_REMOTE_DOWNLOAD et MSGSTATUS_REMOTE_DELETE pour indiquer qu’un message particulier doit être téléchargé ou supprimé de la banque de messages distante. Un fournisseur de transport distant n’a pas besoin d’implémenter la méthode IMAPIFolder ::GetMessageStatus associée. Les clients doivent rechercher dans la table du contenu du dossier pour déterminer la status d’un message.
Remarques pour les appelants
Vous pouvez utiliser la propriété PR_MSG_STATUS d’un message pour négocier une opération de verrouillage de message avec d’autres clients. Désignez un bit comme bit de verrouillage. Pour déterminer si le bit de verrouillage a été défini, examinez la valeur précédente pour status de message dans le paramètre lpulOldStatus. Utilisez les autres bits du paramètre ulNewStatus pour suivre les status de message sans interférer avec le bit de verrouillage.