IPersistMessage::HandsOffMessage
S’applique à : Outlook 2013 | Outlook 2016
Fait en sorte que le formulaire libère son message actuel.
HRESULT HandsOffMessage( void );
Paramètres
Aucun
Valeur renvoyée
S_OK
Le message a été correctement libéré.
Remarques
Les formulaires passent à deux états HandsOff :
Lorsqu’un formulaire est dans l’un de ces états, il est en cours de stockage permanent.
Remarques pour les responsables de l’implémentation
Lorsqu’une visionneuse de formulaires appelle la méthode IPersistMessage ::HandsOffMessage alors que votre formulaire est dans l’état Normal ou NoScribble , appelez de façon récursive HandsOffMessage sur chaque message incorporé dans le message actuel et la méthode IPersistStorage ::HandsOffStorage sur chaque objet OLE incorporé dans le message actuel. Ensuite, relâchez le message actuel et tous les messages incorporés et objets OLE. Si votre formulaire était dans l’état Normal, passez à l’état HandsOffFromNormal. Si votre formulaire était à l’état NoScribble, passez à l’état HandsOffAfterSave. Après une transition réussie, appelez la méthode IUnknown ::Release du message et retournez S_OK.
Lorsqu’une visionneuse de formulaires appelle HandsOffMessage alors que votre formulaire se trouve dans l’un des états HandsOff, retournez E_UNEXPECTED.
Pour plus d’informations sur les différents états d’un formulaire, consultez États du formulaire. Pour plus d’informations sur l’utilisation de l’état HandsOff des objets de stockage, consultez la méthode IPersistStorage ::HandsOffStorage .