IMsgStore::FinishedMsg
Aplica-se a: Outlook 2013 | Outlook 2016
Permite que o provedor do repositório de mensagens execute o processamento em uma mensagem enviada. Esse método é chamado apenas pelo spooler MAPI.
HRESULT FinishedMsg(
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Parâmetros
ulFlags
[in] Reservados; deve ser zero.
cbEntryID
[in] A contagem de bytes no identificador de entrada apontada pelo parâmetro lpEntryID .
Lpentryid
[in] Um ponteiro para o identificador de entrada da mensagem a ser processada.
Valor de retorno
S_OK
O processamento na mensagem enviada foi bem-sucedido.
MAPI_E_NO_SUPPORT
O provedor do repositório de mensagens não dá suporte ao processamento de mensagens enviadas. Esse valor de erro será retornado se o chamador não for o spooler MAPI.
Comentários
O método IMsgStore::FinishedMsg executa o processamento em uma mensagem enviada. Esse processamento pode envolver a exclusão da mensagem, movê-la para uma pasta diferente ou ambas as ações. O tipo de processamento depende se as propriedades PR_DELETE_AFTER_SUBMIT (PidTagDeleteAfterSubmit) e PR_SENTMAIL_ENTRYID (PidTagSentMailEntryId) estão definidas.
Observações para implementadores
Na implementação do FinishedMsg, desbloqueie a mensagem identificada por lpEntryID e execute o processamento apropriado. A mensagem de destino sempre será bloqueada; o spooler MAPI nunca passa o identificador de entrada para uma mensagem desbloqueada para FinishedMsg.
É possível que nem PR_DELETE_AFTER_SUBMIT nem PR_SENTMAIL_ENTRYID esteja definido, ambos estejam definidos ou um ou outro esteja definido. A tabela a seguir descreve a ação que você deve tomar com base nas configurações:
| Propriedade | Valor |
|---|---|
| Se nenhuma propriedade for definida: |
Deixe a mensagem na pasta da qual ela foi enviada (normalmente a Caixa de Saída). |
| Se ambas as propriedades forem definidas: |
Mova a mensagem para a pasta indicada, se desejar, e exclua-a. |
| Se PR_SENTMAIL_ENTRYID estiver definido: |
Mova a mensagem para a pasta indicada. |
| Se PR_DELETE_AFTER_SUBMIT estiver definido: |
Exclua a mensagem. |
Depois de tomar qualquer ação apropriada, chame o método IMAPISupport::D OSentMail .