IMAPISession::PrepareForm
S’applique à : Outlook 2013 | Outlook 2016
Crée un jeton numérique que la méthode IMAPISession ::ShowForm utilise pour accéder à un message.
HRESULT PrepareForm(
LPCIID lpInterface,
LPMESSAGE lpMessage,
ULONG FAR * lpulMessageToken
);
Paramètres
lpInterface
[in] Pointeur vers l’identificateur d’interface (IID) qui représente l’interface à utiliser pour accéder au message. La transmission de la valeur Null entraîne l’utilisation de l’interface standard, ou IMessage. Le paramètre lpInterface doit être null ou IID_IMessage.
lpMessage
[in] Pointeur vers le message à afficher dans le formulaire.
lpulMessageToken
[out] Pointeur vers un jeton de message, qui est utilisé par la méthode IMAPISession ::ShowForm pour accéder au message pointé par lpMessage.
Valeur renvoyée
S_OK
La préparation du formulaire a réussi.
Remarques
La méthode IMAPISession ::P repareForm crée un jeton de message pour le message désigné par le paramètre lpMessage et appelle la méthode IUnknown ::AddRef du message. Ce jeton est passé dans le paramètre ulMessageToken à IMAPISession ::ShowForm.
Remarques pour les appelants
Si l’appel à PrepareForm réussit, relâchez le message pointé par lpMessage en appelant sa méthode IUnknown ::Release avant d’appeler ShowForm. Le fait de ne pas libérer le message avant d’appeler ShowForm peut entraîner des fuites de mémoire.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MAPIFormFunctions.cpp |
OpenMessageModal |
MFCMAPI utilise la méthode IMAPISession ::P repareForm , ainsi que IMAPISession ::ShowForm, pour afficher un message dans un formulaire modal. |