Partager via


IPersistMessage::Save

S’applique à : Outlook 2013 | Outlook 2016

Enregistre un formulaire révisé dans le message à partir duquel il a été chargé ou créé.

HRESULT Save(
  LPMESSAGE pMessage,
  ULONG fSameAsLoad
);

Paramètres

pMessage

[in] Pointeur vers le message.

fSameAsLoad

[in] TRUE pour indiquer que le message pointé par pMessage est le message à partir duquel le formulaire a été chargé ou créé ; sinon, FALSE.

Valeur renvoyée

S_OK

Le formulaire a été enregistré avec succès.

Remarques

Les observateurs de formulaires appellent la méthode IPersistMessage ::Save pour enregistrer un formulaire révisé dans le message à partir duquel il a été chargé ou créé.

Save doit être appelé uniquement lorsque le formulaire est dans son état Normal .

Remarques pour les responsables de l’implémentation

Ne validez pas les modifications enregistrées ; il appartient à l’appelant de valider les modifications. N’apportez jamais de modifications aux propriétés qui appartiennent au message du formulaire, sauf pendant l’appel Enregistrer .

Si fSameAsLoad est défini sur TRUE, vous pouvez enregistrer les modifications apportées au message existant du formulaire. Si fSameAsLoad est défini sur FALSE, vous devez copier toutes les propriétés du message d’origine dans le message pointé par pMessage avant d’effectuer l’enregistrement. Utilisez la méthode IMAPIProp ::CopyTo du message d’origine pour copier les propriétés.

Lorsque toutes les propriétés ont été copiées, entrez l’état NoScribble . Si aucune erreur ne se produit, retournez S_OK. Sinon, retournez l’erreur à partir de l’action ayant échoué.

Si Save est appelé lorsque le formulaire est dans un état autre que Normal, retournez E_UNEXPECTED.

Pour plus d’informations sur l’enregistrement des objets de stockage, consultez la documentation sur les méthodes IPersistStorage .

Voir aussi

IPersistMessage : IUnknown

États du formulaire