MAPIInitIdle

S’applique à : Outlook 2013 | Outlook 2016

Initialise le moteur d’inactivité MAPI pour l’application appelante.

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

LONG MAPIInitIdle(
  LPVOID lpvReserved
);

Paramètres

lpvReserved

[in] R�serv� ; doit �tre �gal � z�ro.

Valeur renvoyée

La fonction MAPIInitIdle retourne zéro si l’initialisation réussit, et 1 dans le cas contraire. Si MAPIInitIdle est appelé plusieurs fois, tous les appels supplémentaires réussissent mais sont ignorés, sauf pour incrémenter le nombre de références.

Remarques

Une application cliente ou un fournisseur de services doit appeler MAPIInitIdle avant d’appeler toute autre fonction de moteur inactive.

Chaque appel à MAPIInitIdle doit être mis en correspondance par un appel ultérieur à MAPIDeInitIdle, sinon le moteur inactif reste en cours d’exécution pour l’application appelante.

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.

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