次の方法で共有

IMAPISupport::ReadReceipt

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

メッセージの読み取りレポートまたは非読み取りレポートを生成します。

HRESULT ReadReceipt(
ULONG ulFlags,
LPMESSAGE lpReadMessage,
LPMESSAGE FAR * lppEmptyMessage
);

パラメーター

ulFlags

[in]読み取りレポートまたは非読み取りレポートの生成方法を制御するフラグのビットマスク。 次のフラグを設定できます。

MAPI_NON_READ

非読み取りレポートが生成されます。 MAPI_NON_READが設定されていない場合は、読み取りレポートが生成されます。

lpReadMessage

[in]レポートを生成するメッセージへのポインター。

lppEmptyMessage

[in, out]入力時に、 lppEmptyMessage は 空のメッセージへのポインターを指します。 出力時に、 lppEmptyMessage は レポート メッセージへのポインターを指します。

戻り値

S_OK

レポートが正常に生成されました。

注釈

IMAPISupport::ReadReceipt メソッドは、メッセージ ストア プロバイダーサポート オブジェクトに対してのみ実装されます。 メッセージ ストア プロバイダーは、lpReadMessage パラメーターによって指されるメッセージの読み取りまたは非読み取りレポートを生成するように MAPI に指示する ReadReceipt を呼び出します。

呼び出し側への注意

PR_READ_RECEIPT_REQUESTED (PidTagReadReceiptRequested) プロパティが設定され、次のいずれかの条件が true の場合は、ReadReceipt を呼び出します。

  • メッセージが読み取られた。
  • メッセージが移動されました。
  • メッセージがコピーされました。
  • メッセージの IMessage::SetReadFlag メソッドが呼び出されました。

メッセージが削除されたときに ReadReceipt を呼び出さないでください。

読み取りレポートまたは非読み取りレポートは、メッセージに対して 1 回だけ送信する必要があります。 メッセージの読み取り状態を追跡し、1 つのメッセージに対して複数のレポートを送信しないでください。

MAPI が ReadReceipt から返されたときに lppEmptyMessage パラメーターが有効なレポート メッセージを指している場合は、IMessage::SubmitMessage メソッドを呼び出してメッセージを送信し、IUnknown:s:Release メソッドを呼び出してポインターを解放します。

ReadReceipt が失敗した場合は、送信されずにメッセージを解放する必要があります。 メッセージの読み取り状態を格納する場合は、後で読み取りレポートまたは非読み取りレポートの生成を試みることができます。

フォルダー内のストアによって生成された読み取りレポートと非読み取りレポートを非表示または表示できます。 非表示フォルダーに読み取りレポートと非読み取りレポートを格納すると、セキュリティを強化できます。

関連項目

IMAPIFolder::DeleteMessages
IMessage::SubmitMessage
PidTagReadReceiptRequested 標準プロパティ
IMAPISupport: IUnknown