IMAPIFormMgr::IsInConflict
S’applique à : Outlook 2013 | Outlook 2016
Détermine si un formulaire peut gérer ses propres conflits de message. Un message est en conflit s’il a été modifié simultanément par plusieurs utilisateurs. Cela peut arriver à des messages dans des dossiers publics.
HRESULT IsInConflict(
ULONG ulMessageFlags,
ULONG ulMessageStatus,
LPCSTR szMessageClass LPMAPIFOLDER pFolderFocus
);
Paramètres
ulMessageFlags
[in] Pointeur vers un masque de bits d’indicateurs copiés à partir de la propriété PR_MESSAGE_FLAGS (PidTagMessageFlags) d’un message qui indique l’état actuel du message.
ulMessageStatus
[in] Masque de bits d’indicateurs définis par le client ou par le fournisseur copiés à partir de la propriété PR_MSG_STATUS (PidTagMessageStatus) d’un message qui fournit des informations supplémentaires sur l’état du message.
szMessageClass
[in] Chaîne qui nomme la classe de message du message.
pFolderFocus
[in] Pointeur vers le dossier qui contient le message. Le paramètre pFolderFocus peut avoir la valeur NULL si un tel dossier n’existe pas (par exemple, si le message est incorporé dans un autre message).
Valeur renvoyée
S_OK
Le formulaire ne gère pas ses propres conflits de messages.
S_FALSE
Le formulaire gère ses propres conflits de messages, ou le message pour lequel les informations ont été transmises n’est pas en conflit.
Remarques
Les observateurs de formulaires appellent la méthode IMAPIFormMgr ::IsInConflict pour déterminer si un formulaire particulier ne gère pas ses propres conflits de messages. IsInConflict vérifie la présence d’un indicateur de conflit dans les paramètres ulMessageFlags et ulMessageStatus . Si un indicateur de conflit est défini, IsInConflict résout la classe de message passée dans le paramètre szMessageClass et retourne S_OK si le formulaire ne gère pas ses propres conflits. IsInConflict retourne S_FALSE si le formulaire gère ses propres conflits.
Un formulaire qui ne gère pas ses propres conflits doit être ouvert à l’aide de la méthode IMAPIFormMgr ::LoadForm et ne peut pas réutiliser un objet de formulaire existant.
Remarques pour les appelants
Les applications clientes doivent généralement gérer des conflits lorsque les applications passent d’un message au message suivant ou précédent dans un dossier. Si un message est en conflit, mais que le serveur de formulaires pour ce message peut gérer les conflits, l’application cliente doit exécuter son code habituel pour afficher le message suivant ou précédent. Si le serveur de formulaires ne peut pas gérer les conflits, l’application cliente doit continuer comme si elle ignorait la classe de message du message suivant ou précédent.
Voir aussi
IMAPIFormAdviseSink::OnActivateNext
Propriété canonique PidTagMessageFlags