IMAPIMessageSite::CopyMessage
Aplica-se a: Outlook 2013 | Outlook 2016
Copia a mensagem atual para uma pasta.
HRESULT CopyMessage(
LPMAPIFOLDER pFolderDestination
);
Parâmetros
pFolderDestination
[in] Um ponteiro para a pasta em que a mensagem deve ser copiada.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_NO_SUPPORT
A operação não tem suporte para este site de mensagens.
Comentários
Objetos de formulário chamam o método IMAPIMessageSite::CopyMessage para copiar a mensagem atual para uma nova pasta. CopyMessage não altera a mensagem que está sendo exibida no momento para o usuário e nenhuma interface para a mensagem recém-criada é retornada ao formulário.
Observações para implementadores
Uma implementação típica do método CopyMessage executa as seguintes tarefas:
Cria uma nova mensagem para a qual a mensagem atual será copiada.
Chama o método IPersistMessage::Save com um ponteiro para a nova mensagem no parâmetro pMessage e FALSE no parâmetro fSameAsLoad .
Chama o método IPersistMessage::SaveCompleted , passando NULL no parâmetro pMessage .
Chama o método IMAPIProp::SaveChanges na nova mensagem.
Para obter uma lista de interfaces relacionadas a servidores de formulário, consulte Interfaces de Formulário MAPI.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::CopyMessage |
Não implementado. |
Confira também
IPersistMessage::SaveCompleted