IXPLogon::ValidateState
Область применения: Outlook 2013 | Outlook 2016
Проверяет внешнее состояние поставщика транспорта.
HRESULT ValidateState(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Параметры
ulUIParam
[в] Дескриптор родительского окна всех диалоговых окон или окон, отображаемых этим методом.
ulFlags
[в] Битовая маска флагов, управляющая выполнением проверка состояния и результатами проверка состояния. Можно задать следующие флаги:
ABORT_XP_HEADER_OPERATION
Пользователь отменил операцию, обычно нажав кнопку Отмена в диалоговом окне. Поставщик транспорта может продолжить работу над операцией или прервать операцию и вернуть MAPI_E_USER_CANCELED.
CONFIG_CHANGED
Проверяет состояние загруженных поставщиков транспорта, заставляя диспетчер очереди MAPI вызывать их метод IXPLogon::AddressTypes . Этот флаг также предоставляет диспетчеру очереди MAPI возможность исправлять критические сбои поставщика транспорта, не заставляя клиентские приложения выходить из системы, а затем снова входить в систему.
FORCE_XP_CONNECT
Пользователь выбрал операцию подключения. Если этот флаг используется с флагом REFRESH_XP_HEADER_CACHE или PROCESS_XP_HEADER_CACHE, действие подключения выполняется без кэширования.
FORCE_XP_DISCONNECT
Пользователь выбрал операцию отключения. Если этот флаг используется с REFRESH_XP_HEADER_CACHE или PROCESS_XP_HEADER_CACHE, действие отключения выполняется без кэширования.
PROCESS_XP_HEADER_CACHE
Записи в таблице кэша заголовков должны быть обработаны, все сообщения, помеченные флагом MSGSTATUS_REMOTE_DOWNLOAD, должны быть загружены, а все сообщения, помеченные флагом MSGSTATUS_REMOTE_DELETE, должны быть удалены. Сообщения с заданными MSGSTATUS_REMOTE_DOWNLOAD и MSGSTATUS_REMOTE_DELETE должны быть перемещены.
REFRESH_XP_HEADER_CACHE
Необходимо скачать новый список заголовков сообщений и очистить все флаги маркировки состояния сообщения.
SUPPRESS_UI
Запрещает поставщику транспорта отображать пользовательский интерфейс.
Возвращаемое значение
S_OK
Вызов выполнен успешно и возвращает ожидаемое значение или значения.
MAPI_E_BUSY
Выполняется еще одна операция; Он должен быть разрешен к завершению или должен быть остановлен перед попыткой выполнения этой операции.
MAPI_E_NO_SUPPORT
Задействованный удаленный поставщик транспорта не поддерживает пользовательский интерфейс, и клиентское приложение должно отображать диалоговое окно.
MAPI_E_USER_CANCEL
Пользователь отменил операцию, обычно нажав кнопку Отмена в диалоговом окне.
Замечания
Spooler MAPI вызывает метод IXPLogon::ValidateState для поддержки вызовов метода IMAPIStatus::ValidateState для объекта состояния. Поставщик транспорта должен отвечать на вызов IXPLogon::ValidateState точно так же, как если бы диспетчер очереди MAPI открыл объект состояния для текущего сеанса входа, а затем вызвал IMAPIStatus::ValidateState для этого объекта.
Для поддержки реализации IMAPIStatus::ValidateState диспетчер spooler MAPI вызывает IXPLogon::ValidateState для всех объектов входа для всех активных поставщиков транспорта, запущенных в сеансе профиля.