MAPI 状態オブジェクト

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

状態オブジェクトは、MAPI リソースに関する情報を報告します。 たとえば、サービス プロバイダー、MAPI 送受信プロセス、アドレス帳などです。

現在のプロファイル内の個々のサービス プロバイダーに関する情報を提供する状態オブジェクトがあります。 MAPI は、サブシステム、MAPI 送受信プロセス、およびアドレス帳の状態オブジェクトを実装する役割を担います。 サブシステム状況オブジェクトは、グローバル情報を提供します。 統合アドレス帳の status オブジェクトは、現在動作しているすべてのアドレス帳プロバイダーの状態を提供します。

すべての状態オブジェクトは、MAPI によって管理されるテーブルで、クライアントにセッションのすべての状態情報を提供する状態テーブルに含まれます。 詳細については、「 状態テーブル」を参照してください。 クライアントは、テーブルを介して、またはサービス プロバイダーのログオン オブジェクトを介して、特定の状態オブジェクトにアクセスできます。 たとえば、アドレス帳プロバイダーの状態オブジェクトにアクセスするには、クライアントから IABLogon::OpenStatusEntry を呼び出すことができます。 詳細については、「 IABLogon::OpenStatusEntry」を参照してください。

クライアントは、状態オブジェクトを使用して次のことができます。

  • セッションの状態について説明します。

  • サービス プロバイダーを監視します。

  • メッセージ転送を制御します。

  • リソースの構成と状態を表示または変更します。

すべての状態オブジェクトは、 IMAPIStatus インターフェイスを 実装します。 詳細については、「 IMAPIStatus : IMAPIProp」を参照してください。 ただし、すべての状態オブジェクトがすべての IMAPIStatus メソッドを完全にサポートしているわけではありません。 状態オブジェクトでサポートされるメソッドにはバリエーションがあるため、クライアントは特定の状態オブジェクトを使用する前に学習する必要があります。 状態オブジェクトは、次の 3 つのプロパティで機能に関する情報を公開するために必要です。

PR_RESOURCE_METHODS (PidTagResourceMethods)

PR_RESOURCE_TYPE (PidTagResourceType)

PR_RESOURCE_FLAGS (PidTagResourceFlags)

状態オブジェクトの実装の詳細については、「 Status オブジェクトの実装」を参照してください。 状態オブジェクトの使用の詳細については、「 Status Table」および「Status Objects」を参照してください。