IMessage::GetAttachmentTable
適用対象: Outlook 2013 | Outlook 2016
メッセージの添付ファイル テーブルを返します。
HRESULT GetAttachmentTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
パラメーター
ulFlags
[in]テーブルの作成に関連するフラグのビットマスク。 次のフラグを設定できます。
MAPI_UNICODE
文字列列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列列は ANSI 形式になります。
MAPI_DEFERRED_ERRORS
呼び出し元のクライアントがテーブルを完全に使用できるようになる前に、 GetAttachmentTable が正常に返されるようにします。 テーブルが使用できない場合、後続の呼び出しを行うとエラーが発生する可能性があります。
lppTable
[out]添付ファイル テーブルへのポインター。
戻り値
S_OK
添付ファイル テーブルが正常に取得されました。
注釈
IMessage::GetAttachmentTable メソッドは、メッセージ内のすべての添付ファイルに関する情報を含む、メッセージの添付ファイル テーブルへのポインターを返します。 クライアントは、添付ファイル テーブルを介してのみ添付ファイルにアクセスできます。 添付ファイルの番号の PR_ATTACH_NUM (PidTagAttachNumber) プロパティを取得することで、クライアントはいくつかの IMessage メソッドを使用して添付ファイルを操作できます。
添付ファイルごとに 1 つの行があります。 添付ファイル テーブル内の列の完全な一覧については、「 添付ファイル テーブル」を参照してください。
通常、添付ファイルとメッセージの両方が IMAPIProp::SaveChanges の呼び出しで保存されるまで、添付ファイルは添付ファイル テーブルに表示されません。 添付ファイル テーブルは動的です。 クライアントが新しい添付ファイルを作成したり、既存の添付ファイルを削除したり、メッセージの添付ファイルに 対して SaveChanges 呼び出しが行われた後に 1 つ以上のプロパティを変更したりすると、添付ファイル テーブルが更新され、新しい情報が反映されます。
一部の添付ファイル テーブルでは、さまざまな制限がサポートされています。他の人はしません。 制限のサポートは、メッセージ ストア プロバイダーの実装によって異なります。
最初に開いたとき、添付ファイル テーブルは必ずしも特定の順序で並べ替えられるとは限りません。
ulFlags パラメーターで MAPI_UNICODE フラグを設定すると、添付ファイル テーブルの次の呼び出しに影響します。
列セットを取得する IMAPITable::QueryColumns。
並べ替え順序を取得する IMAPITable::QuerySortOrder。
Unicode フラグを設定すると、これらの呼び出しから返されるすべての文字列列の情報が Unicode 形式であることを要求します。 ただし、すべてのメッセージ ストア プロバイダーが Unicode をサポートしているわけではないため、このフラグの設定は要求のみです。