IXPLogon::FlushQueues
Gilt für: Outlook 2013 | Outlook 2016
Fordert an, dass der Transportanbieter sofort alle ausstehenden ein- oder ausgehenden Nachrichten übermittelt.
HRESULT FlushQueues(
ULONG_PTR ulUIParam,
ULONG cbTargetTransport,
LPENTRYID lpTargetTransport,
ULONG ulFlags
);
Parameter
ulUIParam
[in] Ein Handle für das übergeordnete Fenster aller Dialogfelder oder Fenster, die von dieser Methode angezeigt werden.
cbTargetTransport
[in] Reserviert. NULL muss sein.
lpTargetTransport
[in] Reserviert; muss NULL sein.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie das Leeren von Nachrichtenwarteschlangen erfolgt. Die folgenden Flags können festgelegt werden:
FLUSH_DOWNLOAD
Die Warteschlange für eingehende Nachrichten sollte geleert werden.
FLUSH_FORCE
Der Transportanbieter sollte diese Anforderung nach Möglichkeit auch dann verarbeiten, wenn dies zeitaufwändig ist.
FLUSH_NO_UI
Der Transportanbieter sollte keine Benutzeroberfläche anzeigen.
FLUSH_UPLOAD
Die Warteschlange für ausgehende Nachrichten sollte geleert werden.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.
Hinweise
Der MAPI-Spooler ruft die IXPLogon::FlushQueues-Methode auf, um dem Transportanbieter mitzuteilen, dass der MAPI-Spooler mit der Verarbeitung von Nachrichten beginnen wird. Der Transportanbieter sollte die IMAPISupport::ModifyStatusRow-Methode aufrufen, um ein geeignetes Bit für seinen Zustand in der PR_STATUS_CODE -Eigenschaft (PidTagStatusCode) seiner status Zeile festzulegen. Nach dem Aktualisieren der status Zeile sollte der Transportanbieter S_OK für den FlushQueues-Aufruf zurückgeben. Der MAPI-Spooler beginnt dann mit dem Senden von Nachrichten, wobei der Vorgang synchron mit dem MAPI-Spooler ist.
Zur Unterstützung der Implementierung der IMAPIStatus::FlushQueues-Methode ruft der MAPI-Spooler IXPLogon::FlushQueues für alle Anmeldeobjekte für aktive Transportanbieter auf, die in einer Profilsitzung ausgeführt werden. Wenn die FlushQueues-Methode eines Transportanbieters als Ergebnis eines Clientanwendungsaufrufs von IMAPIStatus::FlushQueues aufgerufen wird, erfolgt die Nachrichtenverarbeitung asynchron für den Client.