MapiFileDescW結構包含包含儲存為暫存檔案之郵件附件的檔案相關資訊。 該檔案可以包含靜態 OLE 物件、內嵌的 OLE 物件、內嵌訊息，以及其他類型的檔案。
語法
typedef struct {
ULONG ulReserved;
ULONG flFlags;
ULONG nPosition;
PWSTR lpszPathName;
PWSTR lpszFileName;
PVOID lpFileType;
} MapiFileDescW, *lpMapiFileDescW;
成員
ulReserved
類型： ULONG
保留;必須是 0。
flFlags
類型： ULONG
附件旗標的位元遮罩。 您可以設定下列旗標。
| 值 | 意義 |
|---|---|
|
附件是 OLE 物件。 如果 同時設定MAPI_OLE_STATIC ，附件就是靜態 OLE 物件。 如果未 設定MAPI_OLE_STATIC ，附件就是內嵌的 OLE 物件。 |
|
附件是靜態 OLE 物件。 |
如果兩個旗標都未設定，附件會被視為資料檔案。
nPosition
類型： ULONG
用來指出附件在郵件文字中呈現位置的整數。 郵件文字會儲存在MapiMessageW結構的NoteText成員中，而整數會用來識別附件所取代之訊息字串中的特定字元NoteText[nPosition]。
值 -1 (0xFFFFFFFF) 表示未指出附件位置，而且用戶端應用程式必須提供一種方式讓使用者存取附件。
lpszPathName
類型： PWSTR
附加檔案的完整路徑指標。 此路徑應包含磁片磁碟機號和目錄名稱。
lpszFileName
類型： PWSTR
附件檔案名的指標，如收件者所見。 如果正在使用暫存檔，收件者看到的檔案名可能與 lpszPathName 成員中的檔案名不同。
如果 lpszFileName 成員是空的或 Null，則會使用 來自 lpszPathName 的檔案名。
lpFileType
類型： PVOID
附件檔案類型的指標，可使用 MapiFileTagExt 結構表示。
Null值表示未知的檔案類型或作業系統所決定的檔案類型。
備註
簡單的 MAPI 適用于三種內嵌附件：
- 資料檔案附件
- 可編輯的 OLE 物件檔案附件
- 靜態 OLE 物件檔附件
OLE 物件檔是 OLE 物件資料流程的檔案標記法。 用戶端應用程式可以使用讀取檔案內容的 OLESTREAM 物件呼叫 OLE 函式 OleLoadFromStream ，從檔案重新建立 OLE 物件。 如果輸出訊息中包含 OLE 檔案附件，則 OLE 物件資料流程應該直接寫入做為附件的檔案。
使用 MapiFileDescW 成員 nPosition時，用戶端應用程式不應該將兩個附件放在相同的位置。 用戶端應用程式可能不會在訊息文字結尾以外的位置顯示檔案附件。
需求
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 標頭 | mapi.h |