MAPI 資料夾
適用於：Outlook 2013 |Outlook 2016
資料夾是MAPI物件，可作為訊息的基本組織單位。 以階層方式排列，資料夾可以包含訊息和其他資料夾。 資料夾可讓您更輕鬆地尋找和處理訊息。
資料夾會實作 IMAPIFolder 介面，透過 IMAPIContainer 和 IMAPIProp 介面間接繼承自 IUnknown 介面。 用戶端會使用 IMAPIFolder 來建立、複製和刪除訊息和資料夾、擷取和設定訊息狀態，以及設定或清除訊息的讀取旗標。 雖然需要訊息存放區提供者才能支援 IMAPIFolder 中的所有方法，但某些方法會引進訊息存放區提供者可能想要避免的複雜度層級。 MAPI 藉由在 IMAPISupport 介面中實作一些更複雜的資料夾功能，來儲存訊息存放區提供者一些工作。 例如，訊息存放區提供者可以呼叫支持物件中的複製方法，並取得相同的結果，而不是實作自己的複製方法。
資料夾有三種：
根資料夾。
一般資料夾。
搜尋資料夾。
每個訊息存放區至少有一個根資料夾。 根資料夾會出現在階層頂端，並包含訊息和其他資料夾。 無法移動、複製、重新命名或刪除根資料夾。 每個訊息存放區只有一個根資料夾。
大部分的其他資料夾都是一般資料夾。 如同根資料夾，一般資料夾包含訊息和其他資料夾。 不同於根資料夾，它們可以移動、複製、重新命名及刪除。 一般資料夾可以在根資料夾或其他泛型資料夾中建立。 當用戶端在另一個資料夾中建立一般資料夾時，新資料夾稱為子資料夾或子資料夾。 放置新資料夾的資料夾稱為新資料夾的父資料夾。 具有相同父資料夾的一般資料夾稱為同層級資料夾。 根據訊息存放區提供者而定，同層級資料夾和非同層級資料夾不一定具有唯一名稱。 需要同層級資料夾具有唯一名稱的訊息存放區提供者，會在用戶端嘗試在同一個父系中建立兩個名稱相同的資料夾時，傳回錯誤值MAPI_E_COLLISION。
搜尋資料夾包含符合一組預先定義準則的訊息連結。 因為搜尋資料夾包含連結，而不是實際訊息，所以它們實際上是唯讀的。 它們不能包含其他資料夾，也不能將訊息或資料夾移動或複製到其中。 它們不能在其中建立新的訊息;而且無法移動、複製或重新命名它們本身。 從搜尋資料夾刪除訊息時，實際上會從包含訊息的資料夾中刪除。
資料夾類型會儲存在 PR_FOLDER_TYPE (PidTagFolderType) 屬性中。 每個資料夾都會根據其類型，將此屬性設定為 FOLDER_GENERIC、FOLDER_ROOT 或 FOLDER_SEARCH。
每個資料夾都有一個項目識別碼和一個記錄金鑰。 項目標識碼 PR_ENTRYID (PidTagEntryId) ，可供客戶端和服務提供者用來開啟資料夾。 記錄索引鍵 PR_RECORD_KEY (PidTagRecordKey) ，是用來比較資料夾與其他資料夾的二進位值。
資料夾有其他屬性可識別相關資料夾和訊息存放區。 需要下列屬性：
PR_PARENT_ENTRYID (PidTagParentEntryId)
PR_STORE_ENTRYID (PidTagStoreEntryId)
PR_STORE_RECORD_KEY (PidTagStoreRecordKey)
某些資料夾支援 PR_ACCESS (PidTagAccess) 屬性，其描述使用者可以執行的作業類型。 例如， PR_ACCESS 的其中一個有效設定是MAPI_ACCESS_DELETE，這表示可以移除資料夾。 另一個設定 MAPI_ACCESS_MODIFY，表示資料夾應可修改。
如需必要資料夾屬性的完整清單，請參閱 IMAPIFolder 介面。