IMAPIMessageSite::NewMessage
Gilt für: Outlook 2013 | Outlook 2016
Erstellt eine neue Nachricht.
HRESULT NewMessage(
ULONG fComposeInFolder,
LPMAPIFOLDER pFolderFocus,
LPPERSISTMESSAGE pPersistMessage,
LPMESSAGE FAR * ppMessage,
LPMAPIMESSAGESITE FAR * ppMessageSite,
LPMAPIVIEWCONTEXT FAR * ppViewContext
);
Parameter
fComposeInFolder
[in] Gibt an, in welchem Ordner die Nachricht zusammengestellt werden soll. Wenn die Variable FALSE ist, wird der pFolderFocus-Parameter ignoriert, und der Formular-Viewer kann die Nachricht in einem beliebigen Ordner verfassen. Wenn die Variable TRUE ist und NULL im pFolderFocus-Parameter übergeben wird, wird die Nachricht im aktuellen Ordner zusammengesetzt. Wenn die Variable TRUE ist und ein Wert ungleich NULL in pFolderFocus übergeben wird, wird die Nachricht im Ordner erstellt, auf den pFolderFocus zeigt.
pFolderFocus
[in] Ein Zeiger auf den Ordner, in dem die neue Nachricht erstellt wird.
pPersistMessage
[in] Ein Zeiger auf das Formularobjekt für das neue Formular.
ppMessage
[out] Ein Zeiger auf einen Zeiger auf die neue Nachricht.
ppMessageSite
[out] Ein Zeiger auf einen Zeiger auf ein Nachrichtenwebsiteobjekt für die neue Nachricht.
ppViewContext
[out] Ein Zeiger auf einen Zeiger auf einen Ansichtskontext, der für die Übergabe an ein neues Formular mit der neuen Nachricht geeignet ist. Wenn das Formular einen eigenen Ansichtskontext implementiert, kann NULL im ppViewContext-Parameter übergeben werden.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
Hinweise
Formularobjekte rufen die IMAPIMessageSite::NewMessage-Methode auf, um eine neue Nachricht zu erstellen. Das Formular verwendet NewMessage , um eine neue Nachricht und die zugehörige Nachrichtenwebsite aus seiner Ansicht abzurufen. Anschließend kann die neue Nachricht geändert werden.
Sie können auch einen zugeordneten Ansichtskontext abrufen, indem Sie einen Wert ungleich NULL im ppViewContext-Parameter übergeben. Dieser Ansichtskontext kann direkt verwendet oder aggregiert und an die neue Nachricht übergeben werden. Wenn eine vollständige Implementierung erforderlich ist, übergeben Sie NULL in ppViewContext.
Eine Liste der Schnittstellen im Zusammenhang mit Formularservern finden Sie unter MAPI-Formularschnittstellen.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::NewMessage |
MFCMAPI verwendet die IMAPIMessageSite::NewMessage-Methode , um eine neue Nachricht zu erstellen, einen neuen Formular-Viewer zu instanziieren und SetPersist aufzurufen, um die Nachricht im Formular-Viewer festzulegen. Schließlich wird der Formular-Viewer als Nachrichtenwebsite zurückgegeben. |