IMAPIProviderShutdown : IUnknown
適用対象: Outlook 2013 | Outlook 2016
MAPI プロバイダーがシャットダウンに応答できるように、MAPI サブシステムが MAPI クライアントの高速シャットダウンを MAPI プロバイダーに通知できるようにします。
プロパティ | 値 |
---|---|
ヘッダー ファイル: |
Mapidefs.h |
によって公開される: |
プロバイダー オブジェクト: IXPProvider、 IABProvider、または IMSProvider |
実装元: |
MAPI プロバイダー |
呼び出し元: |
MAPI サブシステム |
インターフェイス識別子: |
IID_IMAPIProviderShutdown |
ポインター型: |
LPMAPIPROVIDERSHUTDOWN |
Vtable の順序
プロパティ | 値 |
---|---|
QueryFastShutdown |
MAPI プロバイダーに対して高速シャットダウンのサポートを照会します。 |
NotifyProcessShutdown |
MAPI クライアントが高速シャットダウンを実行することを MAPI プロバイダーに示し、プロバイダーがデータ損失を防ぐためのアクションを実行できるようにします。 |
DoFastShutdown |
MAPI プロバイダーがデータ損失を防ぐために変更を保持するように、MAPI クライアントがすぐに終了することを MAPI プロバイダーに示します。 |
注釈
高速シャットダウンを使用すると、MAPI クライアントは、クライアントと読み込まれた MAPI プロバイダーが MAPI 設定とデータを保存した後、短時間でプロセスを終了できます。 MAPI クライアントは常に高速シャットダウンを開始し、読み込まれた MAPI プロバイダーからの高速シャットダウンのサポートを MAPI サブシステムに照会する必要があります。 管理者は、すべての MAPI クライアントの高速シャットダウンを許可するために必要なプロバイダーサポートのレベルを指定するために、ユーザー レベルで Windows レジストリを設定できます。 レジストリ設定の詳細については、「 高速シャットダウン ユーザー オプション」を参照してください。 ただし、高速シャットダウンがデータ損失なしで正常に発生するには、MAPI プロバイダーは IMAPIProviderShutdown インターフェイスを実装する必要があります。
クライアントの高速シャットダウンをサポートする必要がある MAPI プロバイダーは、 IMAPIProviderShutdown::QueryFastShutdown メソッドで MAPI サブシステムにS_OKを返す必要があります。 MAPI サブシステムが後で IMAPIProviderShutdown::NotifyProcessShutdown メソッドと IMAPIProviderShutdown::D oFastShutdown メソッドを呼び出すと、MAPI プロバイダーは MAPI 設定とデータを保存し、クライアントの終了に備えるために必要なアクションを実行する必要があります。
クライアントの高速シャットダウンをサポートする必要のない MAPI プロバイダーは、引き続き IMAPIProviderShutdown インターフェイスを実装し、 IMAPIProviderShutdown::QueryFastShutdown メソッドからMAPI_E_NO_SUPPORTを返す必要があります。 MAPI クライアントとしての Outlook の場合、Outlook は終了する前にすべての外部参照が解放されるのを待ちます。
高速シャットダウンのユーザーの Windows レジストリ設定によっては、 IMAPIProviderShutdown インターフェイスを実装しないと、クライアントの高速シャットダウンが必ずしも妨げられないわけではありません。
高速シャットダウンのプロセスの詳細については、「高速シャットダウンの 概要」を参照してください。 高速シャットダウンを正常に実行する方法については、「高速シャットダウン のベスト プラクティス」を参照してください。