FNIDLE
S’applique à : Outlook 2013 | Outlook 2016
Définit une routine inactive que le moteur d’inactivité MAPI appelle régulièrement en fonction de la priorité.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapiutil.h |
| Fonction définie implémentée par : |
Applications clientes et fournisseurs de services |
| Fonction définie appelée par : |
MAPI |
| Type de pointeur correspondant : |
PFNIDLE |
BOOL (STDAPICALLTYPE FNIDLE)(
LPVOID lpvContext
);
Paramètres
lpvContext
[in] Pointeur vers un bloc de mémoire que MAPI transmet à la routine inactive chaque fois qu’il l’appelle. Ce pointeur est passé au moteur inactif MAPI dans le paramètre pvIdleParam par FtgRegisterIdleRoutine. Les données du bloc de mémoire peuvent fournir un contexte pour l’appel à la routine inactive, comme l’objet sur lequel opérer ou l’état actuel d’une opération longue.
Valeur renvoyée
FALSE
Une routine inactive avec le prototype FNIDLE doit toujours retourner FALSE.
Remarques
La fonctionnalité spécifique de la routine inactive est déterminée par l’application cliente ou le fournisseur de services qui implémente.
Le client ou le fournisseur doit limiter le temps d’exécution de chaque état d’une routine inactive. Chaque état doit effectuer une quantité minimale de traitement, mettre à jour l’état actuel dans les données de contexte pointées par lpvContext et revenir au moteur inactif MAPI.
Le client ou le fournisseur doit appeler la fonction MAPI MAPIInitIdle avant de pouvoir inscrire sa propre routine inactive avec un appel à la fonction FtgRegisterIdleRoutine .
Les fonctions suivantes traitent du moteur d’inactivité MAPI et des routines inactives basées sur le prototype de fonction FNIDLE :
| Fonction de routine inactive | Utilisation |
|---|---|
|
ChangeIdleRoutine |
Modifie les caractéristiques d’une routine inactive inscrite. |
|
DeregisterIdleRoutine |
Supprime une routine inactive inscrite du système MAPI. |
|
EnableIdleRoutine |
Désactive ou réactive une routine inactive inscrite sans la supprimer du système MAPI. |
|
FtgRegisterIdleRoutine |
Ajoute une routine inactive au système MAPI, avec ou sans activation. |
|
MAPIDeInitIdle |
Arrête le moteur d’inactivité MAPI pour l’application appelante. |
|
MAPIInitIdle |
Initialise le moteur d’inactivité MAPI pour l’application appelante. |
ChangeIdleRoutine, DeregisterIdleRoutine et EnableIdleRoutine prennent comme paramètre d’entrée la balise de fonction retournée par FtgRegisterIdleRoutine.
Lorsque toutes les tâches de premier plan de la plateforme deviennent inactives, le moteur d’inactivité MAPI appelle la routine d’inactivité de priorité la plus élevée qui est prête à s’exécuter. Il n’existe aucune garantie d’appeler l’ordre parmi les routines inactives de la même priorité.