IPersistMessage::Load

Article
03/15/2024

S’applique à : Outlook 2013 | Outlook 2016

Charge le formulaire pour un message spécifié.

HRESULT Load(
  LPMESSAGESITE pMessageSite,
  LPMESSAGE pMessage,
  ULONG ulMessageStatus,
  ULONG ulMessageFlags
);

Paramètres

pMessageSite

[in] Pointeur vers le site de message pour le formulaire à charger.

pMessage

[in] Pointeur vers le message pour lequel le formulaire doit être chargé.

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) du message, qui fournissent des informations sur l’état du message.

ulMessageFlags

[in] Masque de bits d’indicateurs, copié à partir de la propriété PR_MESSAGE_FLAGS (PidTagMessageFlags) du message, qui fournissent des informations supplémentaires sur l’état du message.

Valeur renvoyée

S_OK

Le formulaire a été correctement chargé.

Remarques

Les visionneuses de formulaires appellent la méthode IPersistMessage ::Load pour charger un formulaire pour un message existant.

Remarques pour les responsables de l’implémentation

Load est appelé uniquement lorsqu’un formulaire est dans l’un des états suivants :

Si une visionneuse de formulaires appelle Load alors que le formulaire est dans un autre état, la méthode retourne E_UNEXPECTED.

Si votre formulaire contient une référence à un site de messages actif autre que celui passé à Load, relâchez le site d’origine, car il ne sera plus utilisé. Stockez les pointeurs vers le site de message et le message des paramètres pMessageSite et pMessage , et appelez les méthodes IUnknown ::AddRef des deux objets pour incrémenter leur nombre de références.

Une fois AddRef terminé, stockez les propriétés des paramètres ulMessageStatus et ulMessageFlags dans le formulaire. Faites passer le formulaire à son état Normal avant de l’afficher et informez les utilisateurs inscrits en appelant leurs méthodes IMAPIViewAdviseSink ::OnNewMessage .

Si aucune erreur ne se produit, retournez S_OK.