DeregisterIdleRoutine

Gilt für: Outlook 2013 | Outlook 2016

Entfernt eine FNIDLE-basierte Leerlaufroutine aus dem MAPI-System.

Eigenschaft	Wert
Headerdatei	Mapiutil.h
Implementiert von:	MAPI
Aufgerufen von:	Clientanwendungen und Dienstanbieter

VOID DeregisterIdleRoutine(
  FTG ftg
);

Parameter

Ftg

[in] Funktionstag, das die zu entfernende Leerlaufroutine identifiziert.

Rückgabewert

None.

Hinweise

Jede Aufgabe in einer Clientanwendung oder einem Dienstanbieter kann die Registrierung aller Routinen im Leerlauf aufheben, für die sie über einen gültigen ftg-Parameter verfügt. Insbesondere kann eine Leerlaufroutine die Registrierung selbst aufheben.

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.

Nachdem die Registrierung der Leerlaufroutine aufgehoben wurde, ruft die Idle-Engine sie nicht mehr auf. Jede Implementierung, die DeregisterIdleRoutine aufruft, muss die Zuordnung aller Speicherblöcke aufheben, an die sie Zeiger für die Idle Engine übergeben hat, um sie in ihrem ursprünglichen Aufruf der FtgRegisterIdleRoutine-Funktion zu verwenden.