IPersistMessage::HandsOffMessage
Aplica-se a: Outlook 2013 | Outlook 2016
Faz com que o formulário libere sua mensagem atual.
HRESULT HandsOffMessage( void );
Parâmetros
Nenhum
Valor de retorno
S_OK
A mensagem foi lançada com êxito.
Comentários
Os formulários fazem a transição para dois estados do HandsOff:
Quando um formulário está em qualquer um desses estados, ele está no processo de ser armazenado permanentemente.
Observações para implementadores
Quando um visualizador de formulários chama o método IPersistMessage::HandsOffMessage enquanto seu formulário está no estado Normal ou NoScribble , chame novamente HandsOffMessage em cada mensagem inserida na mensagem atual e o método IPersistStorage::HandsOffStorage em cada objeto OLE inserido na mensagem atual. Em seguida, libere a mensagem atual e todas as mensagens inseridas e objetos OLE. Se o formulário estiver no estado normal, faça a transição para o estado HandsOffFromNormal. Se o formulário estiver no estado NoScribble, faça a transição para o estado HandsOffAfterSave. Após uma transição bem-sucedida, chame o método IUnknown::Release da mensagem e retorne S_OK.
Quando um visualizador de formulários chama HandsOffMessage enquanto seu formulário está em qualquer um dos estados do HandsOff, retorne E_UNEXPECTED.
Para obter mais informações sobre os diferentes estados de um formulário, consulte Estados de Formulário. Para obter mais informações sobre como trabalhar com o estado do HandsOff de objetos de armazenamento, consulte o método IPersistStorage::HandsOffStorage .