IMAPISupport::StatusRecips
適用対象: Outlook 2013 | Outlook 2016
配信レポートと配信不能レポートを生成します。
HRESULT StatusRecips(
LPMESSAGE lpMessage,
LPADRLIST lpRecipList
);
パラメーター
lpMessage
[in]レポートを生成するメッセージへのポインター。
lpRecipList
[in]lpMessage によって指されるメッセージの受信者を記述する ADRLIST 構造体へのポインター。
戻り値
S_OK
レポートが正常に生成されました。
MAPI_W_ERRORS_RETURNED
呼び出しは全体的に成功しましたが、この種類の受信者の受信者オプションはありません。 この警告が返されたら、呼び出しは成功として処理する必要があります。 この警告をテストするには、 HR_FAILED マクロを使用します。 詳細については、「 エラー処理にマクロを使用する」を参照してください。
注釈
IMAPISupport::StatusRecips メソッドは、トランスポート プロバイダーのサポート オブジェクトに実装されます。 トランスポート プロバイダーは StatusRecips を呼び出して、MAPI がメッセージの 1 つ以上の受信者のセットに配信レポートまたは配信不能レポートを送信するように要求します。
呼び出し側への注意
メッセージの処理中 に StatusRecips を複数回呼び出すことができます。 ただし、開いているメッセージに 対して StatusRecips を呼び出す場合は、メッセージ受信者のすべての配信情報と配信不能情報を収集し、その受信者リストの StatusRecips を呼び出してください。 1 つの受信者に対して複数の StatusRecips 呼び出しを行うと、複数の同じレポートが送信される可能性があるため、コレクションの 1 つのポイントが重要です。
lpRecipList パラメーターによって示される ADRLIST 構造体に、メッセージ配信または配信不能に関連するプロパティを格納します。 配信レポートと配信不能レポートの必須プロパティと省略可能なプロパティの完全な一覧については、「 必要なレポート メッセージのプロパティ 」と「 オプションのレポート メッセージプロパティ」を参照してください。
MAPIAllocateBuffer 関数と MAPIAllocateMore 関数を使用して、lpRecipList の ADRLIST 構造体のメモリを割り当てます。 MAPI は、StatusRecips が成功した場合にのみ MAPIFreeBuffer 関数を呼び出してメモリを解放します。
配信レポートと配信不能レポートの概要については、「 MAPI レポート メッセージ」を参照してください。