MAPIInitIdle

Область применения: Outlook 2013 | Outlook 2016

Инициализирует механизм простоя MAPI для вызывающего приложения.

Свойство	Значение
Файл заголовка:	Mapiutil.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения и поставщики услуг

LONG MAPIInitIdle(
  LPVOID lpvReserved
);

Параметры

lpvReserved

[in] ���������������; ������ ���� ����� ����.

Возвращаемое значение

Функция MAPIInitIdle возвращает ноль, если инициализация прошла успешно, и значение 1 в противном случае. Если MAPIInitIdle вызывается несколько раз, все дополнительные вызовы выполняются успешно, но игнорируются, за исключением увеличения числа ссылок.

Замечания

Клиентское приложение или поставщик услуг должны вызвать MAPIInitIdle перед вызовом любой другой функции обработчика бездействия.

Каждый вызов MAPIInitIdle должен сопоставляться с последующим вызовом MAPIDeInitIdle, иначе для вызывающего приложения остается запущенный обработчик бездействия.

Следующие функции работают с подсистемой простоя MAPI и подпрограммами простоя на основе прототипа функции FNIDLE :

Бездействуемая функция подпрограммы	Использование
ChangeIdleRoutine	Изменяет характеристики зарегистрированной процедуры простоя.
DeregisterIdleRoutine	Удаляет зарегистрированную подпрограмму простоя из системы MAPI.
EnableIdleRoutine	Отключает или повторно включает зарегистрированную неактивную подпрограмму, не удаляя ее из системы MAPI.
FtgRegisterIdleRoutine	Добавляет в систему MAPI неактивную подпрограмму с включением или без нее.
MAPIDeInitIdle	Завершает работу модуля простоя MAPI для вызывающего приложения.
MAPIInitIdle	Инициализирует механизм простоя MAPI для вызывающего приложения.

Когда все задачи переднего плана для платформы становятся неактивными, подсистема простоя MAPI вызывает подпрограмму простоя с наивысшим приоритетом, которая готова к выполнению. Нет гарантии вызова порядка между неактивными подпрограммами с одинаковым приоритетом.