IMAPIFormContainer::CalcFormPropSet
S’applique à : Outlook 2013 | Outlook 2016
Retourne un tableau des propriétés utilisées par tous les formulaires installés dans un conteneur de formulaires.
HRESULT CalcFormPropSet(
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Paramètres
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont le tableau de propriétés dans le paramètre ppResults est retourné. Les indicateurs suivants peuvent être définis :
FORMPROPSET_INTERSECTION
Le tableau retourné contient l’intersection des propriétés des formulaires.
FORMPROPSET_UNION
Le tableau retourné contient l’union des propriétés des formulaires.
MAPI_UNICODE
Les chaînes retournées dans le tableau sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les chaînes sont au format ANSI.
ppResults
[out] Pointeur vers un pointeur vers la structure SMAPIFormPropArray retournée. Cette structure contient toutes les propriétés utilisées par les formulaires installés.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_E_BAD_CHARWIDTH
Soit l’indicateur MAPI_UNICODE a été défini et l’implémentation ne prend pas en charge Unicode, soit MAPI_UNICODE n’a pas été défini et l’implémentation prend uniquement en charge Unicode.
Remarques
Les applications clientes appellent la méthode IMAPIFormContainer ::CalcFormPropSet pour obtenir un tableau de propriétés utilisées par tous les formulaires installés dans un conteneur de formulaires. IMAPIFormContainer ::CalcFormPropSet fonctionne comme la méthode IMAPIFormMgr ::CalcFormPropSet , sauf qu’elle fonctionne sur chaque formulaire inscrit dans un conteneur particulier.
Remarques pour les responsables de l’implémentation
Les fournisseurs de bibliothèques de formulaires qui ne prennent pas en charge les chaînes Unicode doivent retourner MAPI_E_BAD_CHARWIDTH si MAPI_UNICODE est passé.
Remarques pour les appelants
IMAPIFormContainer ::CalcFormPropSet prend une intersection ou une union des jeux de propriétés des formulaires, en fonction de l’indicateur défini dans le paramètre ulFlags , et retourne une structure SMAPIFormPropArray qui contient le groupe de propriétés résultant.
Si un client passe l’indicateur MAPI_UNICODE dans ulFlags, toutes les chaînes retournées sont Unicode.