IMessage::DeleteAttach
Gilt für: Outlook 2013 | Outlook 2016
Löscht eine Anlage.
HRESULT DeleteAttach(
ULONG ulAttachmentNum,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Parameter
ulAttachmentNum
[in] Indexnummer der zu löschenden Anlage. Dies ist der Wert für die eigenschaft PR_ATTACH_NUM (PidTagAttachNumber) der Anlage.
ulUIParam
[in] Handle mit dem übergeordneten Fenster aller Dialogfelder oder Fenster, die von dieser Methode angezeigt werden. Der ulUIParam-Parameter wird ignoriert, es sei denn, das flag ATTACH_DIALOG ist im ulFlags-Parameter festgelegt.
lpProgress
[in] Zeiger auf ein Statusobjekt, das eine Statusanzeige anzeigt. Wenn NULL in lpProgress übergeben wird, zeigt der Nachrichtenspeicheranbieter mithilfe der MAPI-Statusobjektimplementierung eine Statusanzeige an. Der lpProgress-Parameter wird ignoriert, es sei denn, das flag ATTACH_DIALOG ist in ulFlags festgelegt.
ulFlags
[in] Bitmaske von Flags, die die Anzeige einer Benutzeroberfläche steuert. Das folgende Flag kann festgelegt werden:
ATTACH_DIALOG
Fordert die Anzeige einer Statusanzeige an, während der Vorgang fortgesetzt wird.
Rückgabewert
S_OK
Die Anlage wurde erfolgreich gelöscht.
Hinweise
Die IMessage::D eleteAttach-Methode löscht eine Anlage aus einer Nachricht.
Eine gelöschte Anlage wird erst endgültig gelöscht, wenn die IMAPIProp::SaveChanges-Methode der Nachricht aufgerufen wurde.
Hinweise für Aufrufer
Rufen Sie vor dem Aufrufen von DeleteAttach die IUnknown::Release-Methode für die Anlage und jeden ihrer Streams auf.
Da das Löschen einer Anlage ein langwieriger Prozess sein kann, stellt DeleteAttach den Mechanismus bereit, der eine Statusanzeige anzeigt. Sie können die Anzeige einer Statusanzeige anfordern, indem Sie einen Zeiger an Ihre IMAPIProgress übergeben: IUnknown-Implementierung oder NULL, wenn Sie über keine Implementierung verfügen. Sie müssen auch ein Fensterhandle im ulUIParam-Parameter und das ATTACH_DIALOG-Flag im ulFlags-Parameter angeben.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| AttachmentsDlg.cpp |
CAttachmentsdlg::OnDeleteselectedItem |
MFCMAPI verwendet die IMessage::D eleteAttach-Methode , um die ausgewählte Anlage zu löschen. |