MAPIInitIdle
Gilt für: Outlook 2013 | Outlook 2016
Initialisiert die MAPI-Leerlauf-Engine für die aufrufende Anwendung.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
LONG MAPIInitIdle(
LPVOID lpvReserved
);
Parameter
lpvReserved
[in] Reserviert. NULL muss sein.
Rückgabewert
Die MAPIInitIdle-Funktion gibt bei erfolgreicher Initialisierung null und andernfalls 1 zurück. Wenn MAPIInitIdle mehrmals aufgerufen wird, sind alle zusätzlichen Aufrufe erfolgreich, werden jedoch ignoriert, außer um die Verweisanzahl zu erhöhen.
Hinweise
Eine Clientanwendung oder ein Dienstanbieter muss MAPIInitIdle aufrufen, bevor eine andere Idle-Engine-Funktion aufgerufen wird.
Jeder Aufruf von MAPIInitIdle muss durch einen nachfolgenden Aufruf von MAPIDeInitIdle abgeglichen werden, andernfalls wird die Leerlauf-Engine für die aufrufende Anwendung ausgeführt.
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. |
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.