IMessage::DeleteAttach

Artigo
04/04/2023

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 .