フォルダー コンテンツ テーブルの表示

適用対象: Outlook 2013 | Outlook 2016

フォルダーの目次には、そのすべてのメッセージに関する概要情報が含まれています。 新しい受信メッセージに関する概要情報は、メッセージ クラスの受信フォルダーのコンテンツ テーブルに表示されます。 この情報をユーザーが使用できるようにするには、テーブルを取得し、必要に応じて列と行を表示します。

フォルダーの内容テーブルを表示するには

  1. IMsgStore::OpenEntry を呼び出し、テーブルを含むフォルダーのエントリ識別子を渡します。

  2. フォルダーの IMAPIContainer::GetContentsTable メソッドを呼び出して、そのコンテンツ テーブルを開きます。

  3. テーブルの IMAPITable::SetColumns メソッドを呼び出して特定の列を指定することで、必要に応じてコンテンツ テーブルのビューを制限します。

  4. テーブルの IMAPITable::Restrict メソッドを呼び出して特定の行をフィルター処理することで、必要に応じてコンテンツ テーブルのビューを制限します。 たとえば、読み取りがまだ行われていない特定のメッセージ クラスを持つメッセージのみを表示する場合は、次のようにします。

    1. PR_MESSAGE_CLASS (PidTagMessageClass) プロパティと目的のメッセージ クラスと一致する SPropertyRestriction 構造体にプロパティ制限を作成します。

    2. PR_MESSAGE_FLAGS (PidTagMessageFlags) をプロパティ タグとして使用し、MSGFLAG_UNREAD値をマスクとして使用する SBitMaskRestriction 構造体にビットマスク制限を作成します。

    3. プロパティとビットマスクの制限を結合する SAndRestriction 構造体に制限を作成します。

  5. テーブルの IMAPITable::SortTable メソッドを呼び出して、必要に応じてコンテンツ テーブルを並べ替えます。

  6. IMAPITable::QueryRows を呼び出して、処理のためにコンテンツ テーブルからすべての行を取得します。