Compartilhar via


IMAPIMessageSite::SubmitMessage

Aplica-se a: Outlook 2013 | Outlook 2016

Solicita que a mensagem atual seja enfileirada para entrega.

HRESULT SubmitMessage(
  ULONG ulFlags
);

Parâmetros

ulFlags

[in] Um bitmask de sinalizadores que controla como uma mensagem é enviada. O seguinte sinalizador pode ser definido:

FORCE_SUBMIT

O MAPI deve enviar a mensagem mesmo que ela não seja enviada imediatamente.

Valor de retorno

S_OK

A chamada foi bem-sucedida e retornou o valor ou valores esperados.

Comentários

Os objetos de formulário chamam o método IMAPIMessageSite::SubmitMessage para solicitar que uma mensagem seja enfileirada para entrega. O site de mensagens deve chamar o método IPersistMessage::HandsOffMessage antes de enviar a mensagem. A mensagem não precisa ter sido salva anteriormente, pois o SubmitMessage deve fazer com que a mensagem seja salva se a mensagem tiver sido modificada. Após o retorno de SubmitMessage, o formulário deve marcar para uma mensagem atual e, em seguida, descartar-se se nenhum existe.

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::SubmitMessage
O MFCMAPI usa o método IMAPIMessageSite::SubmitMessage para salvar a mensagem. Primeiro, ele chama o método IPersistMessage::HandsOffMessage e, em seguida, chama SubmitMessage.

Confira também

IPersistMessage::HandsOffMessage

IMAPIMessageSite : IUnknown

MFCMAPI como exemplo de código

Interfaces de Formulário MAPI