IMAPIFormMgr::CalcFormPropSet
S’applique à : Outlook 2013 | Outlook 2016
Retourne un tableau des propriétés qu’un groupe de formulaires utilise.
HRESULT CalcFormPropSet(
LPSMAPIFORMINFOARRAY pfrminfoarray,
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Paramètres
pfrminfoarray
[in] Pointeur vers un tableau d’objets d’informations de formulaire qui identifient les formulaires pour lesquels retourner des propriétés.
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 du formulaire.
FORMPROPSET_UNION
Le tableau retourné contient l’union des propriétés du formulaire.
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, qui contient les propriétés utilisées par les formulaires.
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la ou les valeurs attendues.
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 visionneuses de formulaires appellent la méthode IMAPIFormMgr ::CalcFormPropSet pour obtenir un tableau des propriétés qu’un groupe de formulaires utilise. CalcFormPropSet prend une intersection ou une union des jeux de propriétés de ces 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.
Remarques pour les responsables de l’implémentation
Si une visionneuse de formulaires transmet l’indicateur MAPI_UNICODE dans le paramètre ulFlags , toutes les chaînes doivent être retournées en tant que chaînes Unicode. 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é.