IMessage::OpenAttach
Gilt für: Outlook 2013 | Outlook 2016
Öffnet eine Anlage.
HRESULT OpenAttach(
ULONG ulAttachmentNum,
LPCIID lpInterface,
ULONG ulFlags,
LPATTACH FAR * lppAttach
);
Parameter
ulAttachmentNum
[in] Indexnummer der zu öffnenden Anlage, die in der PR_ATTACH_NUM -Eigenschaft (PidTagAttachNumber) der Anlage gespeichert ist. Diese Indexnummer identifiziert die Anlage in der Nachricht eindeutig und ist nur im Kontext der Nachricht gültig.
lpInterface
[in] Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), der die Schnittstelle darstellt, die für den Zugriff auf die Anlage verwendet werden soll. Das Übergeben von NULL führt dazu, dass die Standardschnittstelle der Anlage ( IAttach) zurückgegeben wird.
ulFlags
[in] Bitmaske von Flags, die steuert, wie die Anlage geöffnet wird. Die folgenden Flags können festgelegt werden:
MAPI_BEST_ACCESS
Fordert an, dass die Anlage mit den maximal zulässigen Netzwerkberechtigungen für den Benutzer und dem maximalen Clientanwendungszugriff geöffnet wird. Wenn der Client beispielsweise über Lese-/Schreibberechtigungen verfügt, sollte die Anlage mit Lese-/Schreibberechtigung geöffnet werden. Wenn der Client über schreibgeschützten Zugriff verfügt, sollte die Anlage mit schreibgeschütztem Zugriff geöffnet werden.
MAPI_DEFERRED_ERRORS
Ermöglicht es OpenAttach , erfolgreich zurückzugeben, möglicherweise bevor die Anlage für den aufrufenden Client vollständig verfügbar ist. Wenn die Anlage nicht verfügbar ist, kann ein nachfolgendes Aufrufen der Anlage zu einem Fehler führen.
MAPI_MODIFY
Fordert Lese-/Schreibberechtigungen an. Anlagen werden standardmäßig mit schreibgeschütztem Zugriff geöffnet, und Clients sollten nicht unter der Annahme funktionieren, dass lese-/schreibberechtigungen erteilt wurden.
lppAttach
[out] Zeiger auf einen Zeiger auf die geöffnete Anlage.
Rückgabewert
S_OK
Die Anlage wurde erfolgreich geöffnet.
Hinweise
Die IMessage::OpenAttach-Methode öffnet die Anlage einer Nachricht.
Hinweise für Aufrufer
Um eine Anlage zu öffnen, benötigen Sie Zugriff auf ihre Anlagenummer oder PR_ATTACH_NUM Eigenschaft. Rufen Sie IMessage::GetAttachmentTable auf, um die Anlagetabelle der Nachricht abzurufen und die Zeile zu suchen, die die zu öffnende Anlage darstellt. Weitere Informationen finden Sie unter Öffnen einer Anlage .
Versuchen Sie nicht, eine Anlage mehrmals zu öffnen. die Ergebnisse sind nicht definiert und hängen vom Nachrichtenspeicheranbieter ab.
Sie können anfordern, dass die Anlage im Lese-/Schreibmodus statt im schreibgeschützten Standardmodus geöffnet wird. Ob die Anlage jedoch tatsächlich im Lese-/Schreibmodus geöffnet wird, hängt vom Nachrichtenspeicheranbieter ab. Sie können entweder versuchen, die Anlage zu ändern, um mögliche Fehler zu behandeln, oder die Zugriffsebene überprüfen, die gewährt wurde, indem Sie die PR_ACCESS_LEVEL (PidTagAccessLevel)-Eigenschaft der Anlage abrufen, sofern diese verfügbar ist.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| AttachmentsDlg.cpp Verwendet zu |
CAttachmentsDlg::OpenItemProp |
MFCMAPI verwendet die IMessage::OpenAttach-Methode zum Öffnen von Anlagenobjekten, |