FNIDLE
Область применения: Outlook 2013 | Outlook 2016
Определяет неактивную подпрограмму, которую модуль простоя MAPI периодически вызывает в соответствии с приоритетом.
| Свойство | Value (Значение) |
|---|---|
| Файл заголовка: |
Mapiutil.h |
| Определена функция, реализованная: |
Клиентские приложения и поставщики услуг |
| Определенная функция, вызываемая: |
MAPI |
| Соответствующий тип указателя: |
PFNIDLE |
BOOL (STDAPICALLTYPE FNIDLE)(
LPVOID lpvContext
);
Параметры
lpvContext
[в] Указатель на блок памяти, который MAPI передает неактивной подпрограмме при каждом ее вызове. Этот указатель передается в подсистему простоя MAPI в параметре pvIdleParam с помощью FtgRegisterIdleRoutine. Данные в блоке памяти могут содержать контекст для вызова неактивной подпрограммы, например, с каким объектом следует работать, или текущее состояние длительной операции.
Возвращаемое значение
FALSE
Неактивная подпрограмма с прототипом FNIDLE всегда должна возвращать значение FALSE.
Замечания
Конкретные функциональные возможности неактивной подпрограммы определяются реализующим клиентским приложением или поставщиком услуг.
Клиент или поставщик должен ограничить время выполнения каждого состояния неактивной подпрограммы. Каждое состояние должно выполнять минимальный объем обработки, обновлять текущее состояние в контекстных данных, на которые указывает lpvContext, и возвращаться в подсистему простоя MAPI.
Клиент или поставщик должен вызвать функцию MAPI MAPIInitIdle , прежде чем он сможет зарегистрировать собственную неактивную подпрограмму с помощью вызова функции FtgRegisterIdleRoutine .
Следующие функции работают с подсистемой простоя MAPI и подпрограммами простоя на основе прототипа функции FNIDLE:
| Бездействуемая функция подпрограммы | Использование |
|---|---|
|
ChangeIdleRoutine |
Изменяет характеристики зарегистрированной процедуры простоя. |
|
DeregisterIdleRoutine |
Удаляет зарегистрированную подпрограмму простоя из системы MAPI. |
|
EnableIdleRoutine |
Отключает или повторно включает зарегистрированную неактивную подпрограмму, не удаляя ее из системы MAPI. |
|
FtgRegisterIdleRoutine |
Добавляет в систему MAPI неактивную подпрограмму с включением или без нее. |
|
MAPIDeInitIdle |
Завершает работу модуля простоя MAPI для вызывающего приложения. |
|
MAPIInitIdle |
Инициализирует механизм простоя MAPI для вызывающего приложения. |
ChangeIdleRoutine, DeregisterIdleRoutine и EnableIdleRoutine принимают в качестве входного параметра тег функции, возвращаемый FtgRegisterIdleRoutine.
Когда все задачи переднего плана для платформы становятся неактивными, подсистема простоя MAPI вызывает подпрограмму простоя с наивысшим приоритетом, которая готова к выполнению. Нет гарантии вызова порядка между неактивными подпрограммами с одинаковым приоритетом.