IMAPISession::PrepareForm
Gilt für: Outlook 2013 | Outlook 2016
Erstellt ein numerisches Token, das von der IMAPISession::ShowForm-Methode für den Zugriff auf eine Nachricht verwendet wird.
HRESULT PrepareForm(
LPCIID lpInterface,
LPMESSAGE lpMessage,
ULONG FAR * lpulMessageToken
);
Parameter
lpInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), der die Schnittstelle darstellt, die für den Zugriff auf die Nachricht verwendet werden soll. Die Übergabe von NULL führt dazu, dass die Standardschnittstelle ( IMessage) verwendet wird. Der lpInterface-Parameter muss NULL oder IID_IMessage sein.
lpMessage
[in] Ein Zeiger auf die Meldung, die im Formular angezeigt werden soll.
lpulMessageToken
[out] Ein Zeiger auf ein Nachrichtentoken, das von der IMAPISession::ShowForm-Methode verwendet wird, um auf die Nachricht zuzugreifen, auf die von lpMessage verwiesen wird.
Rückgabewert
S_OK
Die Formularvorbereitung war erfolgreich.
Hinweise
Die IMAPISession::P repareForm-Methode erstellt ein Nachrichtentoken für die Nachricht, auf die der lpMessage-Parameter verweist, und ruft die IUnknown::AddRef-Methode der Nachricht auf. Dieses Token wird im ulMessageToken-Parameter an IMAPISession::ShowForm übergeben.
Hinweise für Aufrufer
Wenn der Aufruf von PrepareForm erfolgreich ist, lassen Sie die Nachricht, auf die lpMessage verweist, los, indem Sie die IUnknown::Release-Methode aufrufen, bevor Sie ShowForm aufrufen. Wenn Sie die Nachricht nicht freigeben, bevor Sie ShowForm aufrufen, kann dies zu Speicherverlusten führen.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIFormFunctions.cpp |
OpenMessageModal |
MFCMAPI verwendet die IMAPISession::P repareForm-Methode zusammen mit IMAPISession::ShowForm, um eine Nachricht in einem modalen Formular anzuzeigen. |