IMessage::DeleteAttach
Aplica-se a: Outlook 2013 | Outlook 2016
Exclui um anexo.
HRESULT DeleteAttach(
ULONG ulAttachmentNum,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Parâmetros
ulAttachmentNum
[in] Número de índice do anexo a ser excluído. Esse é o valor da propriedade PR_ATTACH_NUM do anexo (PidTagAttachNumber).
ulUIParam
[in] Manipule para a janela pai de qualquer caixa de diálogo ou janelas que este método exibe. O parâmetro ulUIParam é ignorado, a menos que o sinalizador ATTACH_DIALOG seja definido no parâmetro ulFlags .
lpProgress
[in] Ponteiro para um objeto de progresso que exibe um indicador de progresso. Se NULL for passado em lpProgress, o provedor do repositório de mensagens exibirá um indicador de progresso usando a implementação do objeto de progresso MAPI. O parâmetro lpProgress é ignorado, a menos que o sinalizador ATTACH_DIALOG seja definido em ulFlags.
ulFlags
[in] Bitmask de sinalizadores que controla a exibição de uma interface do usuário. O seguinte sinalizador pode ser definido:
ATTACH_DIALOG
Solicita a exibição de um indicador de progresso à medida que a operação prossegue.
Valor de retorno
S_OK
O anexo foi excluído com êxito.
Comentários
O método IMessage::D eleteAttach exclui um anexo de dentro de uma mensagem.
Um anexo excluído não é excluído permanentemente até que o método IMAPIProp::SaveChanges da mensagem tenha sido chamado.
Notas para chamadores
Antes de chamar DeleteAttach, chame o método IUnknown::Release para o anexo e cada um de seus fluxos.
Como excluir um anexo pode ser um processo longo, DeleteAttach fornece o mecanismo que exibe um indicador de progresso. Você pode solicitar a exibição de um indicador de progresso passando um ponteiro para sua implementação IMAPIProgress : IUnknown ou NULL se você não tiver uma implementação. Você também deve especificar um identificador de janela no parâmetro ulUIParam e o sinalizador ATTACH_DIALOG no parâmetro ulFlags .
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| AttachmentsDlg.cpp |
CAttachmentsDlg::OnDeleteSelectedItem |
O MFCMAPI usa o método IMessage::D eleteAttach para excluir o anexo selecionado. |