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
);
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.
S_OK
Le message status a été récupéré avec succès.
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.
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.
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. |