IMAPIProgress::SetLimits

S’applique à : Outlook 2013 | Outlook 2016

Définit les limites inférieure et supérieure du nombre d’éléments dans l’opération, ainsi que les indicateurs qui contrôlent la façon dont les informations de progression sont calculées pour l’opération.

HRESULT SetLimits(
  LPULONG lpulMin,
  LPULONG lpulMax,
  LPULONG lpulFlags
);

Paramètres

lpulMin

[in] Pointeur vers une variable qui contient la limite inférieure d’éléments dans l’opération.

lpulMax

[in] Pointeur vers une variable qui contient la limite supérieure d’éléments dans l’opération.

lpulFlags

[in] Masque de bits d’indicateurs qui contrôle le niveau d’opération sur lequel les informations de progression sont calculées. L’indicateur suivant peut être défini :

MAPI_TOP_LEVEL

Utilise les valeurs des paramètres ulCount et ulTotal de la méthode IMAPIProgress ::P rogress, qui indiquent respectivement l’élément actuellement traité et le nombre total d’éléments pour incrémenter la progression de l’opération. Lorsque cet indicateur est défini, les valeurs des limites globales inférieure et supérieure doivent être définies.

Valeur renvoyée

S_OK

L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.

Remarques

Les fournisseurs de services appellent la méthode IMAPIProgress ::SetLimits pour définir ou effacer l’indicateur MAPI_TOP_LEVEL et définir des valeurs minimales et maximales locales et globales. La valeur du paramètre d’indicateur détermine si l’objet progress comprend que les valeurs minimales et maximales soient locales ou globales. Lorsque l’indicateur MAPI_TOP_LEVEL est défini, ces valeurs sont considérées comme globales et sont utilisées pour calculer la progression de l’ensemble de l’opération. Les objets progress initialisent la valeur minimale globale sur 1 et la valeur maximale globale sur 1 000.

Lorsque MAPI_TOP_LEVEL n’est pas défini, les valeurs minimale et maximale sont considérées comme locales, et les fournisseurs les utilisent en interne pour afficher la progression des sous-objectifs de niveau inférieur. Les objets Progress enregistrent les valeurs minimales et maximales locales uniquement afin qu’elles puissent être retournées aux fournisseurs lorsque les méthodes IMAPIProgress ::GetMin et IMAPIProgress ::GetMax sont appelées.

Pour plus d’informations sur l’implémentation de SetLimits et des autres méthodes IMAPIProgress , consultez Implémentation d’un indicateur de progression.

Pour plus d’informations sur la méthode et le moment opportun pour appeler un objet de progression, reportez-vous à Affichage d’un indicateur de progression.

Référence MFCMAPI

Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.

Voir aussi

IMAPIProgress ::GetMaxIMAPIProgress ::GetMin
IMAPIProgress::Progress
IMAPIProgress : IUnknownMFCMAPI en tant qu’exemple de code
Affichage d’un indicateur de progression
Implémentation d’un indicateur de progression