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 für die Statusanzeige, die angezeigt wird, während das Formular geöffnet wird. Der ulUIParam-Parameter wird ignoriert, es sei denn, das flag MAPI_DIALOG ist im ulFlags-Parameter festgelegt.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie das Formular geöffnet wird. Das folgende Flag kann festgelegt werden:
MAPI_DIALOG
Zeigt eine Benutzeroberfläche an, um status bereitzustellen oder den Benutzer aufzufordern, weitere Informationen einzugeben. Wenn dieses Flag nicht festgelegt ist, wird keine Benutzeroberfläche 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
Formular-Viewer 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 instance 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 der aufrufende Formular-Viewer mithilfe der IPersistMessage-Schnittstelle eine Nachricht einrichten und kann 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 vor der Anzeige zu erstellen. |