IMAPISupport::SpoolerYield
Gilt für: Outlook 2013 | Outlook 2016
Gibt dem MAPI-Spooler die Kontrolle über die CPU, damit er alle Aufgaben ausführen kann, die er für notwendig hält.
HRESULT SpoolerYield(
ULONG ulFlags
);
Parameter
ulFlags
Reserviert; muss null sein.
Rückgabewert
S_OK
Der Transportanbieter hat die CPU erfolgreich freigegeben.
MAPI_W_CANCEL_MESSAGE
Weist den Transportanbieter an, die Zustellung der Nachricht an alle Empfänger zu beenden, die sie noch nicht empfangen haben.
Hinweise
Die IMAPISupport::SpoolerYield-Methode wird für Transportanbieterunterstützungsobjekte implementiert. Transportanbieter rufen SpoolerYield auf, damit der MAPI-Spooler alle erforderlichen Verarbeitungsschritte durchführen kann.
Hinweise für Aufrufer
Rufen Sie SpoolerYield auf, wenn Sie langwierige Vorgänge ausführen, die angehalten werden können. Dadurch können Vordergrundanwendungen während eines langen Vorgangs ausgeführt werden, z. B. die Übermittlung an eine große Empfängerliste über ein ausgelastetes Netzwerk.
Wenn SpoolerYield mit MAPI_W_CANCEL_MESSAGE zurückgibt, hat der MAPI-Spooler ermittelt, dass die Nachricht nicht mehr gesendet werden soll. Kehren Sie MAPI_E_USER_CANCEL zu Ihrem Anrufprozess zurück, und beenden Sie sie, wenn möglich.
Weitere Informationen zum Bereitstellen an den MAPI-Spooler finden Sie unter Interagieren mit dem MAPI-Spooler.