IMAPIFolder::GetMessageStatus
S’applique à : Outlook 2013 | Outlook 2016
Obtient les status associées à un message dans un dossier particulier (par exemple, si ce message est marqué pour suppression).
HRESULT GetMessageStatus(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulFlags,
ULONG FAR * lpulMessageStatus
);
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 obtenu.
ulFlags
[in] R�serv� ; doit �tre �gal � z�ro.
lpulMessageStatus
[out] Pointeur vers un pointeur vers un masque de bits d’indicateurs qui indiquent la status du message. Les bits 0 à 15 sont réservés et doivent être zéro ; Les bits 16 à 31 sont disponibles pour une utilisation spécifique à l’implémentation. 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.
Valeur renvoyée
S_OK
Le message status a été récupéré avec succès.
Remarques
La méthode IMAPIFolder ::GetMessageStatus retourne la status d’un message. Le status de message est stocké dans la propriété PR_MSG_STATUS (PidTagMessageStatus) du message.
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. Si vous stockez des messages dans la sous-arborescence IPM, MAPI réserve les bits 16 à 31 pour les clients IPM. Si vous stockez des messages dans d’autres sous-arborescences, vous pouvez utiliser les bits 16 à 31 pour vos propres besoins.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer ::GetNextMessage |
MFCMAPI utilise la méthode IMAPIFolder ::GetMessageStatus pour obtenir les status du message suivant à afficher. |
| MAPIFormFunctions.cpp |
OpenMessageNonModal et OpenMessageModal |
MFCMAPI utilise la méthode IMAPIFolder ::GetMessageStatus pour obtenir les status du message à afficher à passer à la visionneuse de formulaires, qui est CMyMAPIFormViewer ou IMAPISession ::ShowForm. |