IMAPIFormMgr::SelectMultipleForms
S’applique à : Outlook 2013 | Outlook 2016
Présente une boîte de dialogue qui permet à l’utilisateur de sélectionner plusieurs formulaires et retourne un tableau d’objets d’informations de formulaire qui décrivent ces formulaires.
HRESULT SelectMultipleForms(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFOARRAY pfrminfoarray,
LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Paramètres
ulUIParam
[in] Handle de la fenêtre parente de la boîte de dialogue affichée.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le type des chaînes passées. L’indicateur suivant peut être défini :
MAPI_UNICODE
Les chaînes transmises sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les chaînes sont au format ANSI.
pszTitle
[in] Pointeur vers une chaîne qui contient les légende de la boîte de dialogue. Si le paramètre pszTitle a la valeur NULL, le fournisseur de bibliothèque de formulaires qui fournit les formulaires fournit une légende par défaut.
pfld
[in] Pointeur vers le dossier à partir duquel sélectionner les formulaires. Si le paramètre pfld a la valeur NULL, les formulaires sont sélectionnés dans le conteneur de formulaires local, personnel ou organization.
pfrminfoarray
[in] Pointeur vers un tableau d’objets d’informations de formulaire présélectionnés pour l’utilisateur.
ppfrminfoarray
[out] Pointeur vers un pointeur vers le tableau retourné d’objets d’informations de formulaire.
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.
MAPI_E_USER_CANCEL
L’utilisateur a annulé l’opération, généralement en cliquant sur le bouton Annuler dans la boîte de dialogue.
Remarques
Les visionneuses de formulaires appellent la méthode IMAPIFormMgr ::SelectMultipleForms pour présenter d’abord une boîte de dialogue qui permet à l’utilisateur de sélectionner plusieurs formulaires, puis de récupérer un tableau d’objets d’informations de formulaire qui décrivent les formulaires sélectionnés. La boîte de dialogue SélectionnerMultipleForms affiche tous les formulaires, qu’ils soient masqués ou non (c’est-à-dire, que leurs propriétés masquées soient ou non claires).
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 sont 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é.