CreateMAPIInitializationMonitor
Gilt für: Outlook 2016 | Outlook 2019
MAPI-Initialisierungsmonitor
Es kann vorkommen, dass eine Anwendung, die MAPI nutzt, wissen möchte, wann die Initialisierung abgeschlossen ist. Beispielsweise verfügt sie über mehrere Threads, die MAPI initialisieren könnten, oder als Reaktion auf die MAPI-Initialisierung möchte die Anwendung einige Aufgaben ausführen, aber nicht immer den MAPI-Stapel starten. Der Initialisierungsmonitor stellt diese Funktionalität über eine Funktion (exportiert aus OLMAPI32.DLL) und einige einfache Schnittstellen bereit, die unten beschrieben werden.
HRESULT CreateMAPIInitializationMonitor(IMAPIInitMonitor** ppInitMonitor);
HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)
Dieser Aus OLMAPI32.DLL exportierte Einstiegspunkt ermöglicht es dem Aufrufer, eine Schnittstelle abzurufen, um den aktuellen Initialisierungszustand abzufragen, einen Rückruf für den Abschluss der Initialisierung einzurichten oder den aktuellen Thread zu blockieren, bis abgeschlossen ist. Das von dieser API zurückgegebene Objekt ist wiederverwendbar und threadsicher und kann von jedem Thread aufgerufen werden, nicht nur von Einem Thread, der es abgerufen hat. Im Gegensatz zu anderen Objekten, die über MAPI verfügbar gemacht werden, ist dieses Objekt außerdem gültig, solange die DLL geladen wird, kann es in Initialisierungssitzungen wiederverwendet und vor oder nach dem Aufruf von MAPIInitialize genutzt werden. Gibt einen Erfolg oder Fehler über ein COM-Standard-HRESULT zurück und weist einem instance von IMAPIInitMonitor einen out-Parameter zu.
Parameter
ppInitMonitor
[out] Ein Zeiger zum Empfangen der neu erstellten instance des MAPI-Initialisierungsmonitors.
Rückgabewerte
S_OK
Eine neue instance des Initialisierungsmonitors wurde erfolgreich erstellt.
E_OUTOFMEMORY
Es war nicht genügend Arbeitsspeicher vorhanden, um ein neues Objekt zu speichern.