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 verfasst werden soll. Wenn die Variable FALSE ist, wird der pFolderFocus-Parameter ignoriert, und die Formularansicht 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 verfasst. Wenn die Variable TRUE ist und ein Wert ungleich NULL in pFolderFocus übergeben wird, wird die Nachricht in dem Ordner verfasst, auf den pFolderFocus verweist.

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 Nachrichtensiteobjekt 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 Nachrichtensite 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.

Siehe auch

IMAPIViewContext : IUnknown

IMAPIMessageSite : IUnknown

MFCMAPI (engl.) als ein Codebeispiel

MAPI-Formularschnittstellen