IMAPIFormMgr::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 szMsgClass,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPMAPIFORMINFO FAR * ppResult
);
Paramètres
szMsgClass
[in] Chaîne qui nomme la classe de message en cours de résolution.
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.
pFolderFocus
[in] Pointeur vers le dossier qui contient le message en cours de résolution. Le paramètre pFolderFocus peut être NULL.
ppResult
[out] Pointeur vers un pointeur vers un 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 szMsgClass ne correspond à la classe de message pour aucun formulaire dans la bibliothèque de formulaires.
Remarques
Les visionneuses de formulaires appellent la méthode IMAPIFormMgr ::ResolveMessageClass pour résoudre une classe de message dans son formulaire dans un conteneur de formulaires. L’objet d’informations de formulaire retourné dans le paramètre ppResult fournit un accès supplémentaire aux propriétés du formulaire qui a la classe de message donnée.
Remarques pour les appelants
Pour résoudre une classe de message en formulaire, une visionneuse de formulaires transmet 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 lorsqu’un serveur de formulaires correspondant exactement n’est pas disponible), l’indicateur MAPIFORM_EXACTMATCH peut être passé dans le paramètre ulFlags . Si le paramètre pFolderFocus a la valeur NULL, le processus de résolution de classe de message n’effectue pas de recherche dans un conteneur de dossiers.
L’ordre des conteneurs recherchés dépend de l’implémentation du fournisseur de bibliothèque de formulaires. Le fournisseur de bibliothèque de formulaires par défaut recherche d’abord le conteneur local, puis le conteneur de dossiers pour le dossier passé, le conteneur de formulaires personnels et, enfin, le conteneur organization.
Les noms de classe de message sont toujours des chaînes ANSI, jamais Unicode.
L’identificateur de classe pour la classe de message résolue est retourné dans le cadre de l’objet d’informations de formulaire. Une visionneuse de formulaires ne doit pas fonctionner sur l’hypothèse que l’identificateur de classe existe dans la bibliothèque OLE tant que la visionneuse de formulaires n’a pas appelé la méthode IMAPIFormMgr ::P repareForm ou la méthode IMAPIFormMgr ::CreateForm .