IXPLogon::FlushQueues
Область применения: Outlook 2013 | Outlook 2016
Запрашивает, чтобы поставщик транспорта немедленно доставлял все ожидающие входящие или исходящие сообщения.
HRESULT FlushQueues(
ULONG_PTR ulUIParam,
ULONG cbTargetTransport,
LPENTRYID lpTargetTransport,
ULONG ulFlags
);
Параметры
ulUIParam
[в] Дескриптор родительского окна всех диалоговых окон или окон, отображаемых этим методом.
cbTargetTransport
[in] ���������������; ������ ���� ����� ����.
lpTargetTransport
[в] Защищены; значение должно иметь значение NULL.
ulFlags
[в] Битовая маска флагов, управляющая тем, как выполняется очистка очереди сообщений. Можно задать следующие флаги:
FLUSH_DOWNLOAD
Очередь входящих сообщений или очереди должны быть промыты.
FLUSH_FORCE
Поставщик транспорта должен обработать этот запрос, если это возможно, даже если это занимает много времени.
FLUSH_NO_UI
Поставщик транспорта не должен отображать пользовательский интерфейс.
FLUSH_UPLOAD
Очередь исходящих сообщений или очереди должны быть сброшены.
Возвращаемое значение
S_OK
Вызов выполнен успешно и возвращает ожидаемое значение или значения.
Замечания
Диспетчер очереди MAPI вызывает метод IXPLogon::FlushQueues , чтобы сообщить поставщику транспорта о том, что диспетчер очереди MAPI начнет обработку сообщений. Поставщик транспорта должен вызвать метод IMAPISupport::ModifyStatusRow , чтобы задать соответствующий бит для своего состояния в свойстве PR_STATUS_CODE (PidTagStatusCode) строки состояния. После обновления строки состояния поставщик транспорта должен вернуть S_OK для вызова FlushQueues . Затем диспетчер очереди MAPI начинает отправку сообщений, при этом операция синхронна с диспетчером очереди MAPI.
Для поддержки реализации метода IMAPIStatus::FlushQueues диспетчер очереди MAPI вызывает IXPLogon::FlushQueues для всех объектов входа для активных поставщиков транспорта, выполняющихся в сеансе профиля. При вызове метода FlushQueues поставщика транспорта в результате вызова клиентского приложения к IMAPIStatus::FlushQueues обработка сообщений выполняется асинхронно для клиента.