IMessage::DeleteAttach
Область применения: Outlook 2013 | Outlook 2016
Удаляет вложение.
HRESULT DeleteAttach(
ULONG ulAttachmentNum,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Параметры
ulAttachmentNum
[в] Номер индекса удаляемого вложения. Это значение свойства PR_ATTACH_NUM вложения (PidTagAttachNumber).
ulUIParam
[в] Дескриптор к родительскому окну любых диалоговых окон или окон, отображаемых этим методом. Параметр ulUIParam игнорируется, если в параметре ulFlags не установлен флаг ATTACH_DIALOG.
lpProgress
[в] Указатель на объект хода выполнения, отображающий индикатор хода выполнения. Если в lpProgress передается значение NULL, поставщик хранилища сообщений отображает индикатор хода выполнения с помощью реализации объекта выполнения MAPI. Параметр lpProgress игнорируется, если флаг ATTACH_DIALOG не установлен в ulFlags.
ulFlags
[в] Битовая маска флагов, управляющая отображением пользовательского интерфейса. Можно задать следующий флаг:
ATTACH_DIALOG
Запрашивает отображение индикатора хода выполнения по мере выполнения операции.
Возвращаемое значение
S_OK
Вложение успешно удалено.
Замечания
Метод IMessage::D eleteAttach удаляет вложение из сообщения.
Удаленное вложение не удаляется окончательно, пока не будет вызван метод IMAPIProp::SaveChanges сообщения.
Примечания для вызывающих методов
Перед вызовом DeleteAttach вызовите метод IUnknown::Release для вложения и каждого из его потоков.
Так как удаление вложения может быть длительным процессом, DeleteAttach предоставляет механизм, который отображает индикатор хода выполнения. Вы можете запросить отображение индикатора хода выполнения, передав указатель на IMAPIProgress : реализация IUnknown или NULL, если у вас нет реализации. Необходимо также указать дескриптор окна в параметре ulUIParam и флаг ATTACH_DIALOG в параметре ulFlags .
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| AttachmentsDlg.cpp |
CAttachmentsDlg::OnDeleteSelectedItem |
MFCMAPI использует метод IMessage::D eleteAttach для удаления выбранного вложения. |