IMAPISession::ShowForm
Gilt für: Outlook 2013 | Outlook 2016
Zeigt ein Formular an.
HRESULT ShowForm(
ULONG_PTR ulUIParam,
LPMDB lpMsgStore,
LPMAPIFOLDER lpParentFolder,
LPCIID lpInterface,
ULONG ulMessageToken,
LPMESSAGE lpMessageSent,
ULONG ulFlags,
ULONG ulMessageStatus,
ULONG ulMessageFlags,
ULONG ulAccess,
LPSTR lpszMessageClass
);
Parameter
ulUIParam
[in] Ein Handle für das übergeordnete Fenster des Formulars.
lpMsgStore
[in] Ein Zeiger auf den Nachrichtenspeicher, der den Ordner enthält, auf den der lpParentFolder-Parameter verweist.
lpParentFolder
[in] Ein Zeiger auf den Ordner, in dem die Dem ulMessageToken-Parameter zugeordnete Nachricht erstellt wurde.
lpInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), der die Schnittstelle darstellt, die für den Zugriff auf die Meldung verwendet werden soll, die im Formular angezeigt wird. Der lpInterface-Parameter muss NULL oder IID_IMessage sein. Die Übergabe von NULL führt dazu, dass die Standardschnittstelle IMessage verwendet wird.
ulMessageToken
[in] Das Token, das der Meldung zugeordnet ist, die im Formular angezeigt werden soll. Der ulMessageToken-Parameter muss auf den Inhalt des lpulMessageToken-Parameters aus dem vorherigen Aufruf von IMAPISession::P repareForm festgelegt werden.
lpMessageSent
[in] Reserviert; muss NULL sein.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie und ob die Nachricht gespeichert wird. Die folgenden Flags können festgelegt werden:
MAPI_NEW_MESSAGE
Die Nachricht wurde noch nie gespeichert (d. a. die IMAPIProp::SaveChanges-Methode wurde noch nie aufgerufen).
MAPI_POST_MESSAGE
Die Nachricht sollte im übergeordneten Ordner gespeichert werden. Die Nachricht wird nicht zum Senden verarbeitet, sondern stattdessen in den Ordner gesendet. Wenn dieses Flag nicht festgelegt ist, wird die Nachricht in den Postausgang kopiert und zum Senden verarbeitet.
ulMessageStatus
[in] Eine Bitmaske von Flags, die aus der eigenschaft PR_MSG_STATUS (PidTagMessageStatus) der Nachricht kopiert wurden, die dem Token im ulMessageToken-Parameter zugeordnet ist. Die Flags enthalten Informationen zum Status der Nachricht.
ulMessageFlags
[in] Eine Bitmaske von Flags, die aus der eigenschaft PR_MESSAGE_FLAGS (PidTagMessageFlags) der Nachricht kopiert wurden, die dem Token im ulMessageToken-Parameter zugeordnet ist. Diese Flags enthalten weitere Informationen zum Status der Nachricht.
ulAccess
[in] Ein Flag, das die Berechtigungsstufe für die Meldung angibt, die im Formular angezeigt wird. Diese Informationen werden aus der eigenschaft PR_ACCESS (PidTagAccess) der Nachricht kopiert, die dem Token im ulMessageToken-Parameter zugeordnet ist.
lpszMessageClass
[in] Ein Zeiger auf die Nachrichtenklasse der Im Formular angezeigten Nachricht, die aus der eigenschaft PR_MESSAGE_CLASS (PidTagMessageClass) der Nachricht kopiert wurde, die dem Token im ulMessageToken-Parameter zugeordnet ist.
Rückgabewert
S_OK
Das Formular wurde erfolgreich angezeigt.
MAPI_E_USER_CANCEL
Der Benutzer hat den Vorgang in der Regel abgebrochen, indem er in einem Dialogfeld auf die Schaltfläche Abbrechen geklickt hat.
Hinweise
Die IMAPISession::ShowForm-Methode zeigt ein Nachrichtenformular an, das von der IMAPISession::P repareForm-Methode vorbereitet wurde.
Hinweise für Aufrufer
Sie sollten nur über einen einzelnen Verweis auf die Nachricht verfügen, die im lpMessage-Parameter der PrepareForm-Methode übergeben wird.
Beachten Sie, dass Formularimplementierungen andere Fehlerwerte als die von MAPI dokumentierten zurückgeben können. Wenn Sie diese Fehlerwerte verwenden können, um eine genauere Bestimmung der Fehlerbedingung vorzunehmen, tun Sie dies. Behandeln Sie diese Fehler andernfalls so, wie Sie MAPI_E_CALL_FAILED.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIFormFunctions.cpp |
OpenMessageModal |
MFCMAPI verwendet die IMAPISession::ShowForm-Methode zusammen mit der PrepareForm-Methode , um eine Nachricht in einem modalen Formular anzuzeigen. |