MAPI レポート メッセージ
適用対象: Outlook 2013 | Outlook 2016
レポート メッセージは、メッセージに関する状態情報を送信者に提示します。
レポート メッセージには、次の 2 種類の一般的な種類があります。
読み取り状態レポート。
配信状態レポート。
状態レポートの読み取り
読み取り状態レポートは、 IMAPISupport::ReadReceipt メソッドの呼び出しを通じてメッセージ ストア プロバイダーによって開始され、 PR_REPORT_ENTRYID (PidTagReportEntryId) プロパティのエントリ識別子によって表される受信者に送信されます。 読み取り状態レポートは自動的には生成されません。を受け取るクライアント アプリケーションは、明示的に要求する必要があります。
読み取りレポートは、メッセージの読み取りフラグが設定されていることを示します。これは、メッセージを開く、印刷する、移動する、またはコピーしたときに発生する可能性があります。 メッセージ ストア プロバイダーが移動操作またはコピー操作に応答して読み取りレポートを生成するかどうかは、メッセージの移動先によって異なります。 別のメッセージ ストアに移動またはコピーされている場合は、ほとんどの場合、読み取りレポートが常に送信されます。 現在のメッセージ ストアで移動またはコピーされている場合は、読み取りレポートが送信される場合と送信されない場合があります。
非読み取りレポートは、メッセージの読み取りフラグが設定されていないこと、および削除済みアイテム フォルダーに配置される前、または制限時間の期限切れ前にメッセージが開かなかったことを示します。 クライアントは IMessage::SetReadFlag メソッドまたは IMAPIFolder::SetReadFlags メソッドを呼び出して、メッセージの読み取りフラグを設定またはクリアできます。
配信状態レポート
配信状態は、メッセージが目的の受信者に達したときに送信される配信レポートと、メッセージが受信者に到達できなかったときに送信される配信不能レポートに反映されます。 配信状態レポートは、 PR_REPORT_ENTRYID プロパティのエントリ識別子で表される受信者に送信され、このプロパティが存在しない場合は送信者に送信されます。
配信レポートは要求によってのみ送信され、元のメッセージは含まれません。 非送信レポートは、非表示にする要求が行われなければ自動的に送信されます。 配信不能レポートには、元のメッセージが添付ファイルとして含まれるので、配信がブロックされたメッセージが問題でなくなった場合に備えて、レポートの受信者がメッセージを再送信できるようにします。 添付されたメッセージは、最初に 送信するために IMessage::SubmitMessage メソッドが呼び出されたときに存在していた元のメッセージに似ています。
1 つ以上の配信状態レポートは、 IMAPISupport::StatusRecips メソッドを呼び出すと、トランスポート プロバイダーによって生成されます。 トランスポート プロバイダーは、メッセージの受信者の一覧を作成します。 受信者がレポートを受信するかどうか、および生成されるレポートの種類は、次によって異なります。
配信レポートは、メッセージがメッセージ ストアに配置される前に 、PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED (PidTagOriginatorDeliveryReportRequested) プロパティを TRUE に設定した受信者に送信されます。
非送信レポートは、 PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED (PidTagOriginatorNonDeliveryReportRequested) プロパティを FALSE に設定していない受信者に送信されます。
非送信レポートを表示するために必要な情報のほとんどは、添付されたメッセージの受信者テーブルに含まれています。 いくつかのプロパティは、レポート自体からのものです。 配信レポートの場合、必要な情報はレポートの受信者テーブルといくつかのレポート プロパティに含まれます。
レポートは、送信されたメッセージのクラスに基づいて、個別のメッセージ クラスを持つメッセージです。 ほとんどのサービス プロバイダーは、メッセージ クラスがピリオドで区切られた複数の部分で構成される名前付け規則を使用します。 最初の部分は "レポート" で、最後の部分はレポートの種類を表す定数です。 中央の部分は、送信されたメッセージのクラス用に予約されています。 たとえば、配信レポートでは、IPM に関する配信レポートのメッセージ クラスである定数 DR が使用されるためです。メモ メッセージは Report.IPM.Note.DR になります。
次の表は、レポートの種類を表す定数を示しています。
| レポートの種類 | メッセージ クラスで使用される定数 |
|---|---|
| 読み取り |
IPNRN |
| Nonread |
IPNNRN |
| 配信 |
博士 |
| 非デリバリー |
Ndr |
対話型クライアントは、MAPI によって提供される標準フォーム、またはレポートのメッセージ クラスのフォーム マネージャーに登録されているカスタム フォームを使用して、レポート メッセージを表示できます。 IPM の非送信レポートを受け取るクライアント。メモ メッセージは、たとえば、失敗した受信者の一覧と、失敗の推奨される理由を示す標準の MAPI フォームを表示できます。 フォームを使用すると、必要に応じてユーザーがメッセージを再送信することもできます。