IMAPIMessageSite::MoveMessage
Aplica-se a: Outlook 2013 | Outlook 2016
Move a mensagem atual para uma pasta.
HRESULT MoveMessage(
LPFOLDER pFolderDestination,
LPMAPIVIEWCONTEXT pViewContext,
LPCRECT prcPosRect
);
Parâmetros
pFolderDestination
[in] Um ponteiro para a pasta em que a mensagem deve ser movida.
pViewContext
[in] Um ponteiro para um objeto de contexto de exibição.
prcPosRect
[in] Um ponteiro para uma estrutura RECT que contém o tamanho e a posição da janela do formulário atual. O próximo formulário exibido também usa esse retângulo de janela.
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::MoveMessage para mover a mensagem atual para uma nova pasta.
Observações para implementadores
A implementação de MoveMessage pelo visualizador de formulários deve chamar o método IMAPIViewContext::ActivateNext , passando o sinalizador VCDIR_MOVE antes de realmente mover a mensagem para uma nova pasta. Para obter a estrutura RECT usada pela janela de um formulário, chame a função GetWindowRect do Windows.
Para obter uma lista de interfaces relacionadas a servidores de formulário, consulte Interfaces de Formulário MAPI.
Notas para chamadores
Após o retorno do MoveMessage, os formulários devem marcar para uma mensagem atual e, em seguida, descartar-se se nenhum existe.
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::MoveMessage |
Não implementado. |
Confira também
IMAPIViewContext::ActivateNext