IMAPIFormContainer::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 pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Paramètres
pMsgClassArray
[in] Pointeur vers un tableau qui contient les noms des classes de message à résoudre. 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 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.
ppfrminfoarray
[out] Pointeur vers un tableau d’objets d’informations de formulaire. Si une application cliente transmet null dans le paramètre pMsgClassArray , 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 applications clientes appellent la méthode IMAPIFormContainer ::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és dans le paramètre 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 dans des formulaires, transmettez un tableau de noms de classes de message à 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), l’indicateur MAPIFORM_EXACTMATCH peut être passé dans le paramètre ulFlags .
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, ne supposez pas que toutes les classes de message ont été correctement résolues. Au lieu de cela, case activée les valeurs du tableau retourné.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
Fichier | Fonction | Commentaire |
---|---|---|
FormContainerDlg.cpp |
CFormContainerDlg ::OnResolveMultipleMessageClasses |
MFCMAPI utilise la méthode IMAPIFormContainer ::ResolveMultipleMessageClasses pour localiser un formulaire associé à un ensemble de classes de message. |