Freigeben über


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.