FNIDLE
適用対象: Outlook 2013 | Outlook 2016
MAPI アイドル エンジンが優先順位に従って定期的に呼び出すアイドル ルーチンを定義します。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapiutil.h |
| によって実装される定義された関数: |
クライアント アプリケーションとサービス プロバイダー |
| によって呼び出される定義済み関数: |
MAPI |
| 対応するポインター型: |
PFNIDLE |
BOOL (STDAPICALLTYPE FNIDLE)(
LPVOID lpvContext
);
パラメーター
lpvContext
[in]MAPI が呼び出すたびにアイドル ルーチンに渡されるメモリ ブロックへのポインター。 このポインターは、 pvIdleParam パラメーターの MAPI アイドル エンジンに FtgRegisterIdleRoutine によって渡されます。 メモリ ブロック内のデータは、操作するオブジェクトや、長い操作の現在の状態など、アイドル 状態ルーチンの呼び出しのコンテキストを提供できます。
戻り値
FALSE
FNIDLE プロトタイプを使用するアイドル ルーチンは、常に FALSE を返す必要があります。
注釈
アイドル ルーチンの特定の機能は、実装するクライアント アプリケーションまたはサービス プロバイダーによって決まります。
クライアントまたはプロバイダーは、アイドル 状態ルーチンの各状態の実行時間を制限する必要があります。 すべての状態は、最小限の処理を実行し、 lpvContext が指すコンテキスト データの現在の状態を更新し、MAPI アイドル エンジンに戻る必要があります。
クライアントまたはプロバイダーは、独自のアイドル ルーチンを FtgRegisterIdleRoutine 関数の呼び出しで登録する前に、MAPI 関数 MAPIInitIdle を呼び出す必要があります。
次の関数は、MAPI アイドル エンジンと、FNIDLE 関数プロトタイプに基づくアイドル ルーチンを扱います。
| アイドル ルーチン関数 | 使用状況 |
|---|---|
| ChangeIdleRoutine |
登録済みアイドル ルーチンの特性を変更します。 |
| DeregisterIdleRoutine |
MAPI システムから登録済みのアイドル ルーチンを削除します。 |
| EnableIdleRoutine |
MAPI システムから削除せずに、登録済みのアイドル ルーチンを無効または再び有効にします。 |
| FtgRegisterIdleRoutine |
MAPI システムにアイドル ルーチンを追加します。有効にするかどうかは関係ありません。 |
| MAPIDeInitIdle |
呼び出し元のアプリケーションの MAPI アイドル エンジンをシャットダウンします。 |
| MAPIInitIdle |
呼び出し元のアプリケーションの MAPI アイドル エンジンを初期化します。 |
ChangeIdleRoutine、 DeregisterIdleRoutine、 EnableIdleRoutine は、 FtgRegisterIdleRoutine によって返される関数タグを入力パラメーターとして受け取ります。
プラットフォームのすべてのフォアグラウンド タスクがアイドル状態になると、MAPI アイドル エンジンは、実行する準備ができている最も優先度の高いアイドル ルーチンを呼び出します。 同じ優先順位のアイドル ルーチン間で、呼び出し順序が保証されません。