IMAPIFormMgr::CreateForm
S’applique à : Outlook 2013 | Outlook 2016
Ouvre un formulaire pour créer un message basé sur la classe de message du formulaire.
HRESULT CreateForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
IMAPIFormInfo pfrminfoToActivate,
REFIID refiidToAsk,
LPVOID FAR * ppvObj
);
Paramètres
ulUIParam
[in] Handle de la fenêtre parente pour l’indicateur de progression affiché lors de l’ouverture du formulaire. Le paramètre ulUIParam est ignoré, sauf si l’indicateur MAPI_DIALOG est défini dans le paramètre ulFlags .
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont le formulaire est ouvert. L’indicateur suivant peut être défini :
MAPI_DIALOG
Affiche une interface utilisateur pour fournir status ou inviter l’utilisateur à obtenir plus d’informations. Si cet indicateur n’est pas défini, aucune interface utilisateur n’est affichée.
pfrminfoToActivate
[in] Pointeur vers l’objet d’informations de formulaire utilisé pour ouvrir le formulaire.
refiidToAsk
[in] Pointeur vers l’identificateur d’interface (IID) pour l’interface à retourner pour l’objet de formulaire qui a été créé. Le paramètre refiidToAsk ne doit pas être NULL.
ppvObj
[out] Pointeur vers un pointeur vers l’interface retournée.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_E_NO_INTERFACE
L’interface demandée n’est pas prise en charge par l’objet de formulaire.
Remarques
Les visionneuses de formulaires appellent la méthode IMAPIFormMgr ::CreateForm pour ouvrir un formulaire afin de créer un message basé sur la classe de message du formulaire. CreateForm ouvre le formulaire en créant un instance du serveur de formulaires pour ce formulaire, comme décrit dans l’objet d’informations de formulaire donné. Si nécessaire, CreateForm appelle la méthode IMAPIFormMgr ::P repareForm pour télécharger le code du serveur de formulaires sur le disque de l’utilisateur.
Le paramètre pfrminfoToActivate doit pointer vers un objet d’informations de formulaire qui a été correctement résolu.
Une fois le formulaire ouvert, la visionneuse de formulaire appelante doit configurer un message à l’aide de l’interface IPersistMessage et peut éventuellement configurer un contexte d’affichage pour le formulaire. Pour plus d’informations, consultez Lancement d’un serveur de formulaires.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI utilise la méthode IMAPIFormMgr ::CreateForm pour créer un formulaire avant de l’afficher. |