IMAPIFolder::GetMessageStatus
適用対象: Outlook 2013 | Outlook 2016
特定のフォルダー内のメッセージに関連付けられている状態を取得します (たとえば、そのメッセージが削除対象としてマークされているかどうかなど)。
HRESULT GetMessageStatus(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulFlags,
ULONG FAR * lpulMessageStatus
);
パラメーター
cbEntryID
[in] lpEntryID パラメーターによって指されるエントリ識別子のバイト数。
lpEntryID
[in]状態が取得されたメッセージのエントリ識別子へのポインター。
ulFlags
[����]�\��Ă��܂��B0 �ɂ���K�v������܂��B
lpulMessageStatus
[out]メッセージの状態を示すフラグのビットマスクへのポインター。 ビット 0 から 15 は予約済みであり、0 である必要があります。ビット 16 から 31 は、実装固有の使用に使用できます。 次のフラグを設定できます。
MSGSTATUS_DELMARKED
メッセージは削除対象としてマークされています。
MSGSTATUS_HIDDEN
メッセージは表示されません。
MSGSTATUS_HIGHLIGHTED
メッセージが強調表示されます。
MSGSTATUS_REMOTE_DELETE
ローカル クライアントにダウンロードせずに、リモート メッセージ ストアでメッセージが削除対象としてマークされています。
MSGSTATUS_REMOTE_DOWNLOAD
メッセージは、リモート メッセージ ストアからローカル クライアントにダウンロードするようにマークされています。
MSGSTATUS_TAGGED
メッセージは、クライアント定義の目的でタグ付けされています。
戻り値
S_OK
メッセージの状態が正常に取得されました。
注釈
IMAPIFolder::GetMessageStatus メソッドは、メッセージの状態を返します。 メッセージの状態は、メッセージの PR_MSG_STATUS (PidTagMessageStatus) プロパティに格納されます。
実装に関するメモ
メッセージ状態ビットの設定、クリア、および使用方法は実装によって完全に異なりますが、ビット 0 から 15 は予約されており、0 である必要があります。 IPM サブツリーにメッセージを格納する場合、MAPI は IPM クライアントで使用するためにビット 16 から 31 を予約します。 他のサブツリーにメッセージを格納する場合は、独自の目的でビット 16 から 31 を使用できます。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetNextMessage |
MFCMAPI では、 IMAPIFolder::GetMessageStatus メソッドを使用して、表示される次のメッセージの状態を取得します。 |
| MAPIFormFunctions.cpp |
OpenMessageNonModal と OpenMessageModal |
MFCMAPI では 、IMAPIFolder::GetMessageStatus メソッドを使用して、フォーム ビューアーに渡すために表示されるメッセージの状態 (CMyMAPIFormViewer または IMAPISession::ShowForm) を取得します。 |