IMsgStore::AbortSubmit
Aplica-se a: Outlook 2013 | Outlook 2016
Tenta remover uma mensagem da fila de saída.
AbortSubmit(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulFlags
);
Parâmetros
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 removido da fila de saída.
ulFlags
[in] Reservados; deve ser zero.
Valor de retorno
S_OK
A mensagem foi removida com êxito da fila de saída.
MAPI_E_NOT_IN_QUEUE
A mensagem identificada por lpEntryID não está mais na fila de saída do repositório de mensagens, normalmente porque já foi enviada.
MAPI_E_UNABLE_TO_ABORT
A mensagem identificada por lpEntryID é bloqueada pelo spooler MAPI e a operação não pode ser anulada.
Comentários
O método IMsgStore::AbortSubmit tenta remover uma mensagem enviada da fila de saída do repositório de mensagens.
Notas para chamadores
Depois que uma mensagem é enviada, abortar o envio chamando AbortSubmit é a única ação que pode ser executada na mensagem. Não espere que AbortSubmit sempre tenha êxito. Dependendo de como o sistema de mensagens subjacente é implementado, talvez não seja possível cancelar o envio da mensagem.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| FolderDlg.cpp |
CFolderDlg::OnAbortSubmit |
O MFCMAPI usa o método IMsgStore::AbortSubmit para anular o envio da mensagem selecionada. |