ChangeIdleRoutine

S’applique à : Outlook 2013 | Outlook 2016

Modifie tout ou partie des caractéristiques d’une routine d’inactivité basée sur FNIDLE .

Valeur	Description
Fichier d’en-tête :	Mapiutil.h
Implémenté par :	MAPI
Appelé par :	Applications clientes et fournisseurs de services

VOID ChangeIdleRoutine(
  FTG ftg,
  PFNIDLE pfnIdle,
  LPVOID pvIdleParam,
  short priIdle,
  ULONG csecIdle,
  USHORT iroIdle,
  USHORT ircIdle
);

Paramètres

Ftg

[in] Balise de fonction qui identifie la routine inactive.

pfnIdle

[in] Pointeur vers la routine inactive.

pvIdleParam

[in] Pointeur vers un nouveau bloc de mémoire que l’implémentation appelante alloue pour la routine inactive.

priIdle

[in] Valeur représentant une nouvelle priorité pour la routine inactive. Les priorités possibles pour les routines définies par l’implémentation sont supérieures ou inférieures à zéro, mais pas zéro. La valeur zéro est réservée à un événement utilisateur tel qu’un clic de souris ou un message WM_PAINT. Les valeurs supérieures à zéro représentent les priorités des tâches en arrière-plan qui ont une priorité plus élevée que les événements utilisateur et qui sont distribuées dans le cadre de la boucle de pompe de messages Windows standard. Les valeurs inférieures à zéro représentent les priorités des tâches inactives qui s’exécutent uniquement pendant le temps d’inactivité de la pompe de messages. Voici quelques exemples de priorités : 1 pour la soumission au premier plan, 1 pour l’insertion de caractères de modification d’alimentation et 3 pour le téléchargement de nouveaux messages.

csecIdle

[in] Nouvelle heure, en centièmes de seconde, à appliquer à la routine inactive. La signification de la valeur de temps initiale varie en fonction de ce qui est passé dans le paramètre iroIdle . Il peut s’agir des suivants :

• Période minimale d’inaction de l’utilisateur qui doit s’écouler avant que le moteur d’inactivité MAPI appelle la routine inactive pour la première fois, si l’indicateur FIROWAIT est défini dans iroIdle. Une fois ce délai écoulé, le moteur inactif peut appeler la routine d’inactivité aussi souvent que nécessaire.

• Intervalle minimal entre les appels à la routine inactive, si l’indicateur FIROINTERVAL est défini dans iroIdle.

iroIdle

[in] Masque de bits d’indicateurs indiquant de nouvelles options pour appeler la routine inactive. L’un des indicateurs suivants doit être défini :

• FIROINTERVAL : l’heure spécifiée par le paramètre csecIdle est l’intervalle minimal entre les appels successifs à la routine inactive.

• FIROONCEONLY : Obsolète. Ne pas utiliser.

• FIROPERBLOCK : Obsolète. Ne pas utiliser.

• FIROWAIT : le temps spécifié par le paramètre csecIdle est la période minimale d’inaction de l’utilisateur qui doit s’écouler avant que le moteur d’inactivité MAPI appelle la routine inactive pour la première fois. Une fois ce délai écoulé, le moteur inactif peut appeler la routine d’inactivité aussi souvent que nécessaire.

ircIdle

[in] Masque de bits des indicateurs utilisés pour indiquer les modifications à apporter à la routine inactive. Les indicateurs suivants peuvent être définis dans n’importe quelle combinaison :

• FIRCCSEC : modification de l’heure associée à la routine inactive, c’est-à-dire une modification indiquée par la valeur passée dans le paramètre csecIdle .

• FIRCIRO : modification des options de la routine inactive, c’est-à-dire une modification indiquée par la valeur passée dans le paramètre iroIdle .

• FIRCPFN : modification apportée au pointeur de routine inactif, c’est-à-dire une modification indiquée par la valeur passée dans le paramètre pfnIdle .

• FIRCPRI : modification de la priorité de la routine inactive, c’est-à-dire une modification indiquée par la valeur passée dans le paramètre priIdle .

• FIRCPV : modification du bloc de mémoire de la routine inactive, c’est-à-dire une modification indiquée par la valeur passée dans le paramètre pvIdleParam .

Valeur renvoyée

Aucun.

Remarques

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