IMAPIFormMgr::CreateForm

Gilt für: Outlook 2013 | Outlook 2016

Öffnet ein Formular, um eine neue Nachricht basierend auf der Nachrichtenklasse des Formulars zu erstellen.

HRESULT CreateForm(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  IMAPIFormInfo pfrminfoToActivate,
  REFIID refiidToAsk,
  LPVOID FAR * ppvObj
);

Parameter

ulUIParam

[in] Ein Handle für das übergeordnete Fenster der Fortschrittsanzeige, die angezeigt wird, während das Formular geöffnet wird. Der ulUIParam-Parameter wird ignoriert, es sei denn, die MAPI_DIALOG-Kennzeichnung wird im ulFlags-Parameter festgelegt.

ulFlags

[in] Eine Bitmaske von Kennzeichnungen, die steuert, wie das Formular geöffnet wird. Die folgende Kennzeichnung kann festgelegt werden:

MAPI_DIALOG

Zeigt eine Benutzerschnittstelle an, um den Status bereitzustellen oder den Benutzer aufzufordern, weitere Informationen einzugeben. Wenn diese Kennzeichnung nicht gesetzt ist, wird keine Benutzerschnittstelle angezeigt.

pfrminfoToActivate

[in] Ein Zeiger auf das Formularinformationsobjekt, das zum Öffnen des Formulars verwendet wird.

refiidToAsk

[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID) für die Schnittstelle, die für das erstellte Formularobjekt zurückgegeben werden soll. Der refiidToAsk-Parameter darf nicht NULL sein.

ppvObj

[out] Ein Zeiger auf einen Zeiger auf die zurückgegebene Schnittstelle.

Rückgabewert

S_OK

Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.

MAPI_E_NO_INTERFACE

Die angeforderte Schnittstelle wird vom Formularobjekt nicht unterstützt.

Hinweise

Formularanzeigen rufen die IMAPIFormMgr::CreateForm-Methode auf, um ein Formular zu öffnen, um eine neue Nachricht basierend auf der Nachrichtenklasse des Formulars zu erstellen. CreateForm öffnet das Formular, indem eine Instanz des Formularservers für dieses Formular erstellt wird, wie im angegebenen Formularinformationsobjekt beschrieben. Bei Bedarf ruft CreateForm die IMAPIFormMgr::P repareForm-Methode auf, um den Formularservercode auf den Datenträger des Benutzers herunterzuladen.

Der pfrminfoToActivate-Parameter muss auf ein Formularinformationsobjekt verweisen, das ordnungsgemäß aufgelöst wurde.

Nachdem das Formular geöffnet wurde, muss die aufrufende Formularanzeige eine Nachricht mithilfe der IPersistMessage-Schnittstelle einrichten und optional einen Ansichtskontext für das Formular einrichten. Weitere Informationen finden Sie unter Starten eines Formularservers.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Datei	Funktion	Kommentar
MAPIFormFunctions.cpp	CreateAndDisplayNewMailInFolder	MFCMAPI verwendet die IMAPIFormMgr::CreateForm-Methode, um ein Formular zu erstellen, bevor es angezeigt wird.

Siehe auch

IMAPIFormMgr::PrepareForm

IPersistMessage : IUnknown

IMAPIFormMgr : IUnknown

MFCMAPI (engl.) als ein Codebeispiel

Starten eines Formularservers