FNIDLE
Gilt für: Outlook 2013 | Outlook 2016
Definiert eine Leerlaufroutine, die die MAPI-Idle-Engine regelmäßig entsprechend der Priorität aufruft.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Definierte Funktion implementiert von: |
Clientanwendungen und Dienstanbieter |
| Definierte Funktion aufgerufen von: |
MAPI |
| Entsprechender Zeigertyp: |
PFNIDLE |
BOOL (STDAPICALLTYPE FNIDLE)(
LPVOID lpvContext
);
Parameter
lpvContext
[in] Zeiger auf einen Speicherblock, den MAPI bei jedem Aufruf an die Leerlaufroutine übergibt. Dieser Zeiger wird von FtgRegisterIdleRoutine an die MAPI-Idle-Engine im parameter pvIdleParam übergeben. Die Daten im Speicherblock können Kontext für den Aufruf der Leerlaufroutine bereitstellen, z. B. welches Objekt ausgeführt werden soll, oder den aktuellen Zustand eines langwierigen Vorgangs.
Rückgabewert
FALSE
Eine Leerlaufroutine mit dem FNIDLE-Prototyp sollte immer FALSE zurückgeben.
Hinweise
Die spezifische Funktionalität der Leerlaufroutine wird von der implementierenden Clientanwendung oder dem Dienstanbieter bestimmt.
Der Client oder Anbieter muss die Ausführungszeit jedes Zustands einer Routine im Leerlauf begrenzen. Jeder Zustand sollte eine Mindestverarbeitung durchführen, den aktuellen Zustand in den Kontextdaten aktualisieren, auf die lpvContext verweist, und zur MAPI-Idle-Engine zurückkehren.
Der Client oder Anbieter muss die MAPI-Funktion MAPIInitIdle aufrufen, bevor er seine eigene Idle-Routine mit einem Aufruf der FtgRegisterIdleRoutine-Funktion registrieren kann.
Die folgenden Funktionen befassen sich mit der MAPI-Leerlauf-Engine und mit Leerlaufroutinen, die auf dem FNIDLE-Funktionsprototyp basieren:
| Idle Routine-Funktion | Nutzung |
|---|---|
| ChangeIdleRoutine |
Ändert die Merkmale einer registrierten Leerlaufroutine. |
| DeregisterIdleRoutine |
Entfernt eine registrierte Leerlaufroutine aus dem MAPI-System. |
| EnableIdleRoutine |
Deaktiviert oder aktiviert eine registrierte Leerlaufroutine erneut, ohne sie aus dem MAPI-System zu entfernen. |
| FtgRegisterIdleRoutine |
Fügt dem MAPI-System eine Leerlaufroutine mit oder ohne Aktivierung hinzu. |
| MAPIDeInitIdle |
Fährt die MAPI-Leerlauf-Engine für die aufrufende Anwendung herunter. |
| MAPIInitIdle |
Initialisiert die MAPI-Leerlauf-Engine für die aufrufende Anwendung. |
ChangeIdleRoutine, DeregisterIdleRoutine und EnableIdleRoutine verwenden als Eingabeparameter das von FtgRegisterIdleRoutine zurückgegebene Funktionstag.
Wenn alle Vordergrundaufgaben für die Plattform im Leerlauf sind, ruft die MAPI-Idle-Engine die Leerlaufroutine mit der höchsten Priorität auf, die ausgeführt werden kann. Es gibt keine Garantie für die Aufrufreihenfolge bei Leerlaufroutinen mit derselben Priorität.