IXPLogon::FlushQueues
適用於:Outlook 2013 |Outlook 2016
要求傳輸提供者立即傳遞所有擱置的輸入或輸出訊息。
HRESULT FlushQueues(
ULONG_PTR ulUIParam,
ULONG cbTargetTransport,
LPENTRYID lpTargetTransport,
ULONG ulFlags
);
參數
ulUIParam
[in]這個方法所顯示之任何對話框或視窗的父視窗句柄。
cbTargetTransport
[in]保留;必須是零。
lpTargetTransport
[in]保留;必須是 NULL。
ulFlags
[in]旗標的位掩碼,控制如何完成消息佇列排清。 您可以設定下列旗標:
FLUSH_DOWNLOAD
應排清輸入消息佇列或佇列。
FLUSH_FORCE
如果可能,傳輸提供者應該處理此要求,即使這樣做很耗時。
FLUSH_NO_UI
傳輸提供者不應該顯示使用者介面。
FLUSH_UPLOAD
輸出消息佇列或佇列應該排清。
傳回值
S_OK
呼叫成功,並傳回預期的值。
註解
MAPI 多任務緩衝處理程式會呼叫 IXPLogon::FlushQueues 方法,告知傳輸提供者 MAPI 多任務緩衝處理程式即將開始處理訊息。 傳輸提供者應該呼叫 IMAPISupport::ModifyStatusRow 方法,以在其狀態 數據列的 PR_STATUS_CODE (PidTagStatusCode) 属性中設定適當的狀態位。 更新其狀態數據列之後,傳輸提供者應該會針對 FlushQueues 呼叫傳回S_OK。 MAPI 多任務緩衝處理器接著會開始傳送訊息,並將作業同步處理至MAPI多任務緩衝處理器。
為了支援其 IMAPIStatus::FlushQueues 方法的實作,MAPI 多任務緩衝器會針對配置檔會話中執行之使用中傳輸提供者的所有登入物件呼叫 IXPLogon::FlushQueues 。 當傳輸提供者的 FlushQueues 方法因為用戶端應用程式呼叫 IMAPIStatus::FlushQueues 而呼叫時,會以異步方式對客戶端進行訊息處理。