DeregisterIdleRoutine
適用対象: Outlook 2013 | Outlook 2016
MAPI システムから FNIDLE ベースのアイドル ルーチンを削除します。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapiutil.h |
| 実装元: |
MAPI |
| 呼び出し元: |
クライアント アプリケーションとサービス プロバイダー |
VOID DeregisterIdleRoutine(
FTG ftg
);
パラメーター
ftg
[in]削除するアイドル ルーチンを識別する関数タグ。
戻り値
なし。
注釈
クライアント アプリケーションまたはサービス プロバイダー内のタスクは、有効な ftg パラメーターを持つアイドル ルーチンの登録を解除できます。 特に、アイドル 状態のルーチンは、それ自体の登録を解除できます。
次の関数は、MAPI アイドル エンジンと 、FNIDLE 関数プロトタイプに基づくアイドル ルーチンを扱います。
| アイドル ルーチン関数 | 使用状況 |
|---|---|
| ChangeIdleRoutine |
登録済みアイドル ルーチンの特性を変更します。 |
| DeregisterIdleRoutine |
MAPI システムから登録済みのアイドル ルーチンを削除します。 |
| EnableIdleRoutine |
MAPI システムから削除せずに、登録済みのアイドル ルーチンを無効または再び有効にします。 |
| FtgRegisterIdleRoutine |
MAPI システムにアイドル ルーチンを追加します。有効にするかどうかは関係ありません。 |
| MAPIDeInitIdle |
呼び出し元のアプリケーションの MAPI アイドル エンジンをシャットダウンします。 |
| MAPIInitIdle |
呼び出し元のアプリケーションの MAPI アイドル エンジンを初期化します。 |
ChangeIdleRoutine、 DeregisterIdleRoutine、 EnableIdleRoutine は、 FtgRegisterIdleRoutine によって返される関数タグを入力パラメーターとして受け取ります。
プラットフォームのすべてのフォアグラウンド タスクがアイドル状態になると、MAPI アイドル エンジンは、実行する準備ができている最も優先度の高いアイドル ルーチンを呼び出します。 同じ優先順位のアイドル ルーチン間で、呼び出し順序が保証されません。
アイドル ルーチンが登録解除されると、アイドル エンジンは再び呼び出しません。 DeregisterIdleRoutine を呼び出す実装では、FtgRegisterIdleRoutine 関数の元の呼び出しで使用するアイドル エンジンのポインターを渡したメモリ ブロックの割り当てを解除する必要があります。