短期エントリ ID
適用対象: Outlook 2013 | Outlook 2016
短期エントリ識別子は、識別子を迅速に構築する必要があり、時間や距離を超えて持続する必要がない場合に、サービス プロバイダーによってオブジェクトに割り当てられます。 短期エントリ識別子の一意性は、現在のワークステーション上の現在のセッションの有効期間中にのみ保証されます。 通常、短期エントリ識別子は、それが表すオブジェクトが解放されるまでのみ有効です。
短期的なエントリ識別子は、テーブル内の行とダイアログ ボックス内のエントリに割り当てられます。ここでは、参照のためにデータをすばやく提供する必要があります。 たとえば、メッセージ ストア プロバイダーは、コンテンツ テーブル内のメッセージの行と受信者テーブルの受信者に、短期的なエントリ識別子を割り当てます。
クライアントは、これらの短期エントリ識別子を使用して、テーブル行で表されるオブジェクトを開くことができます。 ただし、任意の OpenEntry メソッドで使用できる長期的なエントリ識別子とは異なり、コンテナーの OpenEntry メソッドで短期エントリ識別子を使用する必要があります。
短期エントリ識別子の実装
短期エントリ識別子を実装する最も一般的な方法は次のとおりです。
短期エントリ識別子を長期識別子と同じにし、すべてのフラグを設定解除します。
短期エントリ識別子を長期識別子とは異なる形式にし、すべてのフラグを設定します。
クライアントは、 abFlags メンバーを次のように調べることで、2 番目の型の短期エントリ識別子を識別できます。
abFlags[0] = 0xFF;
一部のサービス プロバイダーでは、1 つ以上のフラグをクリアして、有効期間が大きい短期エントリ識別子を作成します。 たとえば、次の abFlags メンバーは、複数の日または複数のセッションで使用できる短期エントリ識別子を表します。
abFlags[0] = 0xFF & ~MAPI_NOW;
abFlags[0] = 0xFF & ~MAPI_THISSESSION;
クライアントは、短期間のエントリ識別子をすばやく取得、使用、破棄します。 ほとんどの場合、長期エントリ識別子と同じ方法で使用できます。 テーブルから取得し、 OpenEntry メソッドに渡し、 CompareEntryIDs メソッドと比較できます。 1 つの例外は、 IMAPIProp::GetProps メソッドから返されない点です。 GetProps から返されるプロパティは、常に長期的なエントリ識別子です。