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é.