次の方法で共有

MapiFileDescW 構造体 (mapi.h)

  • [アーティクル]

MapiFileDescW 構造体には、一時ファイルとして格納されているメッセージ添付ファイルを含むファイルに関する情報が含まれています。 このファイルには、静的 OLE オブジェクト、埋め込み OLE オブジェクト、埋め込みメッセージ、およびその他の種類のファイルを含めることができます。

構文

typedef struct {
  ULONG ulReserved;
  ULONG flFlags;
  ULONG nPosition;
  PWSTR lpszPathName;
  PWSTR lpszFileName;
  PVOID lpFileType;
} MapiFileDescW, *lpMapiFileDescW;

メンバー

ulReserved

種類: ULONG

予約;は 0 である必要があります。

flFlags

種類: ULONG

添付ファイル フラグのビットマスク。 次のフラグを設定できます。

値 説明
MAPI_OLE
0x00000001
 添付ファイルは OLE オブジェクトです。 MAPI_OLE_STATICも設定されている場合、添付ファイルは静的 OLE オブジェクトです。 MAPI_OLE_STATICが設定されていない場合、添付ファイルは埋め込み OLE オブジェクトです。
MAPI_OLE_STATIC
0x00000002
 添付ファイルは、静的 OLE オブジェクトです。
 

どちらのフラグも設定されていない場合、添付ファイルはデータ ファイルとして扱われます。

nPosition

種類: ULONG

添付ファイルがメッセージ テキストに表示される場所を示すために使用される整数。 メッセージ テキストは MapiMessageW 構造体の NoteText メンバーに格納され、添付ファイルに置き換えられるメッセージ文字列 NoteText[nPosition]内の特定の文字を識別するためのインデックスとして整数が使用されます。

値 -1 (0xFFFFFFFF) は、添付ファイルの位置が示されていないことを意味し、クライアント アプリケーションは、ユーザーが添付ファイルにアクセスする方法を提供する必要があります。

lpszPathName

種類: PWSTR

添付ファイルの完全修飾パスへのポインター。 このパスには、ディスク ドライブ文字とディレクトリ名を含める必要があります。

lpszFileName

種類: PWSTR

受信者に表示される添付ファイルのファイル名へのポインター。 受信者が見るファイル名は、一時ファイルが使用されている場合、 lpszPathName メンバーのファイル名と異なる場合があります。

lpszFileName メンバーが空または NULL の場合は、lpszPathName のファイル名が使用されます。

lpFileType

種類: PVOID

添付ファイルの種類へのポインター。 MapiFileTagExt 構造体で表すことができます。

NULL の値は、不明なファイルの種類またはオペレーティング システムによって決定されるファイルの種類を示します。

解説

シンプルな MAPI は、次の 3 種類の埋め込み添付ファイルで動作します。

  • データ ファイルの添付ファイル
  • 編集可能な OLE オブジェクトの添付ファイル
  • 静的 OLE オブジェクトの添付ファイル
データ ファイルの添付ファイルは、単なるデータ ファイルです。 OLE オブジェクト の添付ファイルは、メッセージ テキストに表示される OLE オブジェクトです。 OLE 添付ファイルが編集可能な場合、受信者はそれをダブルクリックすると、そのソース アプリケーションが開始され、編集セッションが処理されます。 OLE 添付ファイルが静的な場合、オブジェクトは編集できません。 MapiFileDescW 構造体の flFlags メンバーに設定されたフラグによって、特定の添付ファイルの種類が決まります。 埋め込みメッセージは、 によって識別できます。 lpszFileName メンバーの MSG 拡張機能。

OLE オブジェクト ファイルは、OLE オブジェクト ストリームのファイル表現です。 クライアント アプリケーションは、ファイルの内容を読み取る OLESTREAM オブジェクトを使用して OLE 関数 OleLoadFromStream を呼び出すことによって、ファイルから OLE オブジェクトを再作成できます。 OLE ファイルの添付ファイルが送信メッセージに含まれている場合は、OLE オブジェクト ストリームを添付ファイルとして使用するファイルに直接書き込む必要があります。

MapiFileDescW メンバー nPosition を使用する場合、クライアント アプリケーションは 2 つの添付ファイルを同じ場所に配置しないでください。 クライアント アプリケーションでは、メッセージ テキストの末尾を超える位置に添付ファイルが表示されない場合があります。

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
Header mapi.h

関連項目

MAPISendMailW

MapiFileDesc

MapiMessageW