PidTagMessageFlags 標準プロパティ
適用対象: Outlook 2013 | Outlook 2016
メッセージの配信元と現在の状態を示すフラグのビットマスクを格納します。
| プロパティ | 値 |
|---|---|
| 関連するプロパティ: |
PR_MESSAGE_FLAGS |
| 識別子: |
0x0E07 |
| データの種類 : |
PT_LONG |
| エリア: |
一般的なメッセージング |
注釈
このプロパティは、送信の送信側と受信側の両方で公開される転送不可のメッセージ プロパティであり、関連するクライアント アプリケーションまたはストア プロバイダーに応じて異なる値を持ちます。 このプロパティは、メッセージが初めて作成および保存されたときにクライアントまたはメッセージ ストア プロバイダーによって初期化され、メッセージが処理され、その状態が変わると、メッセージ ストア プロバイダー、トランスポート プロバイダー、および MAPI スプーラーによって定期的に更新されます。
このプロパティは、送信前と送信後の両方のメッセージと、受信したメッセージのすべてのコピーに存在します。 受信者プロパティではありませんが、その受信者が読み取りまたは変更したかどうかに応じて、各受信者に異なる方法で公開されます。
このプロパティには、次の 1 つ以上のフラグを設定できます。
MSGFLAG_ASSOCIATED
メッセージは、フォルダーの関連付けられたメッセージです。 クライアントまたはプロバイダーは、このフラグへの読み取り専用アクセス権を持っています。 MSGFLAG_READ フラグは、関連付けられているメッセージでは無視され、読み取り/未読状態は保持されません。
MSGFLAG_FROMME
送信するメッセージング ユーザーは、メッセージを受信しているメッセージング ユーザーでした。 クライアントまたはプロバイダーは、最初の IMAPIProp::SaveChanges 呼び出しとその後の読み取り専用になるまで、このフラグへの読み取り/書き込みアクセス権を持ちます。 このフラグは、トランスポート プロバイダーによって設定されることを意味します。
MSGFLAG_HASATTACH
メッセージには少なくとも 1 つの添付ファイルがあります。 このフラグは、メッセージの PR_HASATTACH (PidTagHasAttachments) プロパティに対応します。 クライアントは、このフラグへの読み取り専用アクセス権を持ちます。
MSGFLAG_NRN_PENDING
メッセージに対して非読み取りレポートを送信する必要があります。 クライアントまたはプロバイダーは、このフラグへの読み取り専用アクセス権を持っています。
MSGFLAG_ORIGIN_INTERNET
受信メッセージはインターネット経由で到着しました。 これは、organizationの外部またはゲートウェイが信頼されたと見なすことができないソースから発生しました。 クライアントは、ユーザーに適切なメッセージを表示する必要があります。 トランスポート プロバイダーは、このフラグを設定します。クライアントは読み取り専用アクセス権を持っています。
MSGFLAG_ORIGIN_MISC_EXT
受信メッセージは、X.400 またはインターネット以外の外部リンク経由で到着しました。 これは、organizationの外部またはゲートウェイが信頼されたと見なすことができないソースから発生しました。 クライアントは、ユーザーに適切なメッセージを表示する必要があります。 トランスポート プロバイダーは、このフラグを設定します。クライアントは読み取り専用アクセス権を持っています。
MSGFLAG_ORIGIN_X400
受信メッセージは X.400 リンク経由で到着しました。 これは、organizationの外部またはゲートウェイが信頼されたと見なすことができないソースから発生しました。 クライアントは、ユーザーに適切なメッセージを表示する必要があります。 トランスポート プロバイダーは、このフラグを設定します。クライアントは読み取り専用アクセス権を持っています。
MSGFLAG_ORIGIN_EXT_SEND
メッセージは、organizationの外部で発生しました。 クライアントは、ユーザーに適切なメッセージを表示する必要があります。 トランスポート プロバイダーは、このフラグを設定します。クライアントは読み取り専用アクセス権を持っています。
MSGFLAG_READ
メッセージは読み取り済みとしてマークされます。 これは、 IMessage::SetReadFlag または IMAPIFolder::SetReadFlags への呼び出しの結果として発生する可能性があります。 クライアントは、メッセージが初めて保存される前に、メッセージの IMAPIProp::SetProps メソッドを呼び出すことによって、このフラグを設定することもできます。 MSGFLAG_ASSOCIATED フラグが設定されている場合、このフラグは無視されます。
MSGFLAG_RESEND
メッセージには、非送信レポートを使用した再送信操作の要求が含まれています。 クライアントまたはプロバイダーは、最初の IMAPIProp::SaveChanges 呼び出しとその後の読み取り専用になるまで、このフラグへの読み取り/書き込みアクセス権を持ちます。
MSGFLAG_RN_PENDING
メッセージの読み取りレポートを送信する必要があります。 クライアントまたはプロバイダーは、このフラグへの読み取り専用アクセス権を持っています。
MSGFLAG_SUBMIT
メッセージは、 IMessage::SubmitMessage の呼び出しの結果として送信するようにマークされます。 メッセージ ストア プロバイダーは、このフラグを設定します。クライアントは読み取り専用アクセス権を持っています。
MSGFLAG_UNMODIFIED
送信メッセージは、最初に保存されてから変更されていません。受信メッセージは、配信されてから変更されていません。
MSGFLAG_UNSENT
メッセージはまだ構成中です。 これは保存されますが、送信されていません。 クライアントまたはプロバイダーは、最初の IMAPIProp::SaveChanges 呼び出しとその後の読み取り専用になるまで、このフラグへの読み取り/書き込みアクセス権を持ちます。 クライアントがメッセージの送信時刻までにこのフラグを設定しない場合、メッセージ ストア プロバイダーは IMessage::SubmitMessage が呼び出されたときに設定します。 通常、このフラグはメッセージの送信後にクリアされます。
クライアントまたはメッセージ ストア プロバイダーは、IMAPIProp::GetProps メソッドを呼び出してフラグ値を読み取ることによって、メッセージの現在の状態をいつでもチェックできます。 クライアントまたはプロバイダーは、 IMAPIProp::SetProps メソッドを呼び出して、現在読み取り/書き込みアクセス権を持つフラグを変更することもできます。
いくつかのフラグは常に読み取り専用です。 IMAPIProp::SaveChanges メソッドの最初の呼び出しまで読み取り/書き込みが行われ、その後、IMAPIProp::SetProps に関する限り読み取り専用になります。 これらの 1 つ(MSGFLAG_READ)は、 後で IMessage::SetReadFlag または IMAPIFolder::SetReadFlags を使用して変更できます。
通常、このプロパティの初期値はMSGFLAG_UNSENTされ、まだ送信または変更されていないメッセージを示すためにMSGFLAG_UNMODIFIEDされます。 メッセージが 2 回目に保存されると、メッセージ ストア プロバイダーは MSGFLAG_UNMODIFIED フラグをクリアします。 メッセージを保存するときにメッセージ ストア プロバイダーが設定できるもう 1 つの値は、メッセージに 1 つ以上の添付ファイルがあることを示すMSGFLAG_HASATTACH フラグです。 PR_HASATTACH プロパティは、この設定から計算されます。
クライアントが IMessage::SubmitMessage メソッドを呼び出してメッセージを送信すると、メッセージ ストア プロバイダーは MAPI スプーラーのコピーを作成し、MSGFLAG_SUBMIT フラグを設定してこのプロパティを更新します。 メッセージ ストア プロバイダーは、まだ設定されていない場合MSGFLAG_UNSENTも設定します。 MSGFLAG_SUBMITは 、SubmitMessage が呼び出され、送信プロセスが開始され、メッセージがクライアントに対して読み取り専用になったことを示します。 MSGFLAG_UNSENTは、MAPI スプーラーがメッセージを処理していることを示します。 送信プロセスが取り消された場合、メッセージ ストア プロバイダーはこのフラグをリセットします。
メッセージが配信のためにトランスポート プロバイダーに渡されると、送信者がメッセージを受信したときと同じアカウントがメッセージング サーバーに存在する場合、トランスポート プロバイダーは MSGFLAG_FROMME フラグを設定します。 トランスポート プロバイダーは、現在ログオンしているユーザーによって送信された受信メッセージのMSGFLAG_FROMMEを設定します。 クライアントは、この値を使用して、送信者名よりも送信済みアイテム フォルダーのコンテンツ テーブルに受信者名を表示する方が適切であると判断できます。 合成プロセス中に保存され、まだ送信されていないメッセージも、送信者名ではなく受信者名で表示する必要があります。
受信メッセージの場合、メッセージ ストア プロバイダーはMSGFLAG_READ フラグをクリアして読み取り状態をリセットします。 クライアントは、メッセージの IMessage::SetReadFlag メソッドまたはそのフォルダーの IMAPIFolder::SetReadFlags メソッドを呼び出すことによって、読み取り状態を変更し、読み取りレポートと非読み取りレポートの送信を制御する必要がある場合に、MSGFLAG_READ フラグを設定またはクリアできます。 これらのメソッドのメイン違いは、それらを実装するオブジェクトとは異なり、フォルダー メソッドがフォルダー内のメッセージの 1 つ、複数、またはすべてのメッセージに影響を与える可能性があるということです。 message メソッドは、1 つのメッセージに影響します。
クライアントは、MSGFLAG_ORIGIN_X400、MSGFLAG_ORIGIN_INTERNET、MSGFLAG_ORIGIN_MISC_EXT、およびMSGFLAG_ORIGIN_EXT_SEND フラグの受信メッセージもテストする必要があります。 これらのフラグは受信トランスポート プロバイダーによって設定され、ゲートウェイが信頼しているとは考えることができないソースからメッセージが到着したことを示します。 これは、メッセージがorganizationの外部、または内部的に、ゲートウェイに認識されていないワークステーションから送信されたことを意味します。 いずれの場合も、送信者の身元が確認されず、コンピュータウイルスをorganizationに導入するリスクがあります。 クライアントはユーザーに警告メッセージを表示し、メッセージを開かずに削除するオプションを提供する必要があります。
メッセージ ストア プロバイダーは、受信メッセージのMSGFLAG_UNMODIFIED フラグを設定します。 MSGFLAG_UNMODIFIEDは、配信後にメッセージが変更されていないことを示します。 クライアントは、メッセージ ストア プロバイダーによって設定された後、この値をクリアできません。
関連リソース
プロトコル仕様
関連するExchange Serverプロトコル仕様への参照を提供します。
メッセージ オブジェクトと添付ファイル オブジェクトを処理します。
ヘッダー ファイル
Mapidefs.h
データ型の定義を提供します。
Mapitags.h
代替名として一覧表示されるプロパティの定義が含まれます。