IMAPIFormContainer::ResolveMessageClass
S’applique à : Outlook 2013 | Outlook 2016
Résout une classe de message dans son formulaire dans un conteneur de formulaires et retourne un objet d’informations de formulaire pour ce formulaire.
HRESULT ResolveMessageClass(
LPCSTR szMessageClass,
ULONG ulFlags,
LPMAPIFORMINFO FAR * ppforminfo
);
Paramètres
szMessageClass
[in] Chaîne qui nomme la classe de message en cours de résolution. Les noms de classe de message sont toujours des chaînes ANSI, jamais Unicode.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont la classe de message est résolue. L’indicateur suivant peut être défini :
MAPIFORM_EXACTMATCH
Seules les chaînes de classe de message qui correspondent exactement doivent être résolues.
ppforminfo
[out] Pointeur vers un pointeur vers l’objet d’informations de formulaire retourné.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_E_NOT_FOUND
La classe de message passée dans le paramètre szMessageClass ne correspond à la classe de message pour aucun formulaire dans le conteneur de formulaires.
Remarques
Les applications clientes appellent la méthode IMAPIFormContainer ::ResolveMessageClass pour résoudre une classe de message en formulaire dans un conteneur de formulaires. L’objet d’informations de formulaire retourné dans le paramètre ppforminfo fournit un accès supplémentaire aux propriétés du formulaire avec la classe de message donnée.
Remarques pour les appelants
Pour résoudre une classe de message dans un formulaire, transmettez le nom de la classe de message à résoudre (par exemple, IPM.HelpDesk.Software). Pour forcer la résolution à être exacte (autrement dit, pour empêcher la résolution vers une classe de base de la classe de message), l’indicateur MAPIFORM_EXACTMATCH peut être passé dans le paramètre ulFlags .
L’identificateur de classe pour la classe de message résolue est retourné dans le cadre de l’objet d’informations de formulaire. Ne supposez pas que l’identificateur de classe existe dans la bibliothèque OLE tant qu’après avoir appelé la méthode IMAPIFormMgr ::P repareForm ou IMAPIFormMgr ::CreateForm .
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| FormContainerDlg.cpp |
CFormContainerDlg ::OnResolveMessageClass |
MFCMAPI utilise la méthode IMAPIFormContainer ::ResolveMessageClass pour localiser un formulaire associé à une classe de message. |