IMAPIFormMgr::ResolveMultipleMessageClasses
S’applique à : Outlook 2013 | Outlook 2016
Résout un groupe de classes de message en leurs formulaires dans un conteneur de formulaires et retourne un tableau d’objets d’informations de formulaire pour ces formulaires.
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClasses,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Paramètres
pMsgClasses
[in] Pointeur vers un tableau qui contient les noms des classes de message à résoudre.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont les classes de message sont résolues. L’indicateur suivant peut être défini :
MAPIFORM_EXACTMATCH
Seules les chaînes de classe de message qui correspondent exactement doivent être résolues.
MAPIFORM_LOCALONLY
N’incluez pas les formulaires mis en cache.
pFolderFocus
[in] Pointeur vers le dossier qui contient le formulaire dont la classe de message est en cours de résolution. Le paramètre pFolderFocus peut être NULL.
ppfrminfoarray
[out] Pointeur vers un tableau d’objets d’informations de formulaire. Si une visionneuse de formulaires transmet null dans le paramètre pMsgClasses , le paramètre ppfrminfoarray contient des objets d’informations de formulaire pour tous les formulaires du conteneur.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
Remarques
Les visionneuses de formulaires appellent la méthode IMAPIFormMgr ::ResolveMultipleMessageClasses pour résoudre un groupe de classes de messages en formulaires dans un conteneur de formulaires. Le tableau d’objets d’informations de formulaire retourné dans ppfrminfoarray fournit un accès supplémentaire à chacune des propriétés des formulaires.
Remarques pour les appelants
Pour résoudre un groupe de classes de message en formulaires, une visionneuse de formulaires transmet un tableau de noms de classes de messages à résoudre. 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 .
Les noms de classe de message sont toujours des chaînes ANSI, jamais Unicode.
Si une classe de message ne peut pas être résolue en formulaire, null est retourné pour cette classe de message dans le tableau d’informations du formulaire. Par conséquent, même si la méthode retourne S_OK, les visionneuses de formulaires ne doivent pas fonctionner sur l’hypothèse que toutes les classes de message ont été correctement résolues. Au lieu de cela, les visionneuses de formulaires doivent case activée les valeurs du tableau retourné.