IXPLogon::EndMessage
Aplica-se a: Outlook 2013 | Outlook 2016
Informa ao provedor de transporte que o spooler MAPI concluiu seu processamento em uma mensagem de saída.
HRESULT EndMessage(
ULONG ulMsgRef,
ULONG FAR * lpulFlags
);
Parâmetros
ulMsgRef
[in] Um valor de referência específico da mensagem obtido em uma chamada anterior para o método IXPLogon::SubmitMessage .
lpulFlags
[out] Um bitmask de sinalizadores que indica ao spooler MAPI o que ele deve fazer com a mensagem. Se nenhum sinalizador for definido, a mensagem será enviada. Os seguintes sinalizadores podem ser definidos:
END_DONT_RESEND
O provedor de transporte tem todas as informações necessárias sobre essa mensagem por enquanto. Quando o provedor de transporte requer mais informações ou quando envia a mensagem, ele notifica o spooler MAPI chamando o método IMAPISupport::SpoolerNotify com o sinalizador NOTIFY_SENTDEFERRED e passando o identificador de entrada da mensagem.
END_RESEND_LATER
O provedor de transporte não está enviando a mensagem no momento atual por motivos que não são condições de erro. O provedor de transporte deve ser chamado novamente mais tarde para enviar a mensagem.
END_RESEND_NOW
O provedor de transporte precisa reiniciar a mensagem passada para ela em uma chamada de método IMessage::SubmitMessage .
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
O spooler MAPI chama o método IXPLogon::EndMessage depois de concluir o processamento envolvido no fornecimento de informações de entrega estendida ou não.
Depois que essa chamada retorna, o valor no parâmetro ulMsgRef não é mais válido para essa mensagem. O provedor de transporte pode reutilizar o mesmo valor em uma mensagem futura.
Todos os objetos abertos pelo provedor de transporte durante a transferência de uma mensagem devem ser liberados antes que a chamada EndMessage retorne, com exceção do objeto de mensagem que o spooler MAPI passa para o provedor de transporte. O objeto de mensagem passado pelo spooler MAPI é inválido após a chamada EndMessage .