IPersistMessage::Save
Aplica-se a: Outlook 2013 | Outlook 2016
Salva um formulário revisado de volta para a mensagem da qual ele foi carregado ou criado.
HRESULT Save(
LPMESSAGE pMessage,
ULONG fSameAsLoad
);
Parâmetros
pMessage
[in] Um ponteiro para a mensagem.
fSameAsLoad
[in] TRUE para indicar que a mensagem apontada pelo pMessage é a mensagem da qual o formulário foi carregado ou criado; caso contrário, FALSE.
Valor de retorno
S_OK
O formulário foi salvo com êxito.
Comentários
Os visualizadores de formulário chamam o método IPersistMessage::Save para salvar um formulário revisado de volta à mensagem da qual ele foi carregado ou criado.
Salvar só deve ser chamado quando o formulário estiver em seu estado normal .
Observações para implementadores
Não confirme as alterações salvas; cabe ao chamador confirmar as alterações. Nunca faça alterações nas propriedades que pertencem à mensagem do formulário, exceto durante a chamada Salvar .
Se fSameAsLoad estiver definido como TRUE, você poderá salvar as alterações na mensagem existente do formulário. Se fSameAsLoad estiver definido como FALSE, você deverá copiar todas as propriedades da mensagem original para a mensagem apontada por pMessage antes de executar a salvação. Use o método IMAPIProp::CopyTo da mensagem original para copiar as propriedades.
Quando todas as propriedades tiverem sido copiadas, insira o estado NoScribble . Se não ocorrerem erros, retorne S_OK. Caso contrário, retorne o erro da ação com falha.
Se Salvar for chamado quando o formulário estiver em qualquer estado diferente de Normal, retorne E_UNEXPECTED.
Para obter mais informações sobre como salvar objetos de armazenamento, consulte a documentação nos métodos IPersistStorage .