IMessage::SubmitMessage
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
9/8/2008
The SubmitMessage método salva todas as propriedades da mensagem e marca a mensagem como pronta ser enviada. As mensagens marcadas são automaticamente movidas para a Caixa de saída pasta onde eles serão entregues durante o próximo sincronização.
Syntax
HRESULT SubmitMessage (
ULONG ulFlags
);
Parameters
- ulFlags
[no] Ignorado.
Return Value
This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.
- S_OK
Indica sucesso.
- MAPI_E_NO_RECIPIENTS
Tabela destinatário da mensagem está vazio.
Remarks
MAPI passa mensagens para o subjacente sistema na ordem na qual eles estão marcados para enviar mensagens. Devido a essa funcionalidade, uma mensagem pode permanecer em armazenar uma mensagem por algum tempo antes de subjacente mensagens sistema podem levar responsabilidade para ele. A ordem de recebimento de destino está na subjacente de mensagens controle do sistema e não corresponde necessariamente a ordem em que as mensagens foram enviadas.
Quando IMessage::SubmitMessage Retorna, todos os ponteiros para a mensagem e seu associado sub-objetos — mensagens, pastas, anexos, fluxos, tabelas e assim por diante, são não mais válido. MAPI não permite quaisquer operações adicionais sobre esses ponteiros, Except for chamado seus métodos IUnknown::Release. Após IMessage::SubmitMessage é chamado, você deve versão a mensagem e todas as sub-Objects associado. No entanto, se IMessage::SubmitMessage Retorna um valor de erro indicando ausente ou inválido informações, o mensagem permanece aberto e os ponteiros permanecem válido.
Para cancelar uma operação de envio, aberto o Caixa de saída pasta e chamar IMAPIFolder::DeleteMessages sobre a mensagem. Observe, no entanto, que devido a problemas temporização, não há nenhuma garantia de que a mensagem já não foi enviada.
Requirements
| Header | mapidefs.h |
| Library | cemapi.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |