此版本的新功能
適用於:Outlook 2013 |Outlook 2016
Microsoft Outlook MAPI 參考已更新為包含各種新功能的檔。
新增內容
已針對下列功能新增內容:
Outlook 2013 MAPI 參考 使用者入門 主題已更新為參考 Outlook 和 MAPI 功能之程式設計模型的完整資訊,以協助您識別最適合您需求的 API 和技術。 下列主題中也修訂了所參考技術文章的連結:
訊息存放區提供者範例— 範 例包裝的 PST 存放區提供者 程式代碼現在已修改為辨識並容納 Outlook 2013。 如需詳細資訊,請參閱本主題中先前修改過的內容。
自動完成 Stream- 昵稱快取主題,先前稱為 Nk2 檔格式,已更新以反映 Outlook 2013 和 Outlook 2010 中的變更。 現在已修訂下列主題,以提供適用於 Microsoft Outlook 2003/Microsoft Office Outlook 2007 和二進位檔剖析的 .nk2 檔格式開發人員指導方針相關信息。 如需詳細資訊,請參閱本主題中先前修改過的內容。
Interfaces-TheIAddrBook::OpenEntry topic documents a method of opening an address book entry and returning a pointer to the interface used to access it. 它先前在 ulFlags 參數 MAPI_GAL_ONLY中包含旗標,可用來開啟全域通訊清單 (GAL) ,而且已修改為包含其定義。
屬性: 已新增 PR_CONVERSATION_KEYPidTagConversationKey Canonical 屬性) 主題 (具名屬性,且與 IPM 相關。 僅限 Outlook MAPI 中的 MessageManager 訊息。 下列與它相關的主題和 Transport-Neutral 封裝格式 (TNEF) 資料流檔已修改:
MAPI 初始化監視器
- 有時候,取用 MAPI 的應用程式可能會想要知道初始化何時完成。 例如,它有多個線程可以初始化MAPI,或回應MAPI正在初始化,應用程式會想要執行一些工作,但不想要一律啟動MAPI堆疊。 初始化監視器會透過從 OLMAPI32.DLL) 導出的函式 (,以及下面所述的幾個簡單介面,來提供這項功能。
HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor (IMAPIInitMonitor ppInitMonitor)
- 這是從 OLMAPI32.DLL 導出的進入點,這可讓呼叫端擷取介面來查詢目前的初始化狀態、設定初始化完成的回呼,或封鎖目前的線程,直到完成為止。 從此 API 傳回的物件可重複使用且具備線程安全,而且可以從任何線程叫用,而不只是擷取它的線程。 此外,不同於從 MAPI 公開的其他物件,只要載入 DLL,這個物件就有效,它可以在初始化會話之間重複使用,而且可以在呼叫 MAPIInitialize 之前或之後使用。 透過 COM 標準 HRESULT 傳回成功或失敗,並將 out 參數指派給 IMAPIInitMonitor 的實例。
介面:IMAPIInitMonitor
IFACEMETHODIMP_ (BOOL) IsInitialized ()
- 傳回MAPI初始化的目前狀態
IFACEMETHODIMP 等候 (DWORD 逾時)
- 在這裡執行緒上起始 BLOCKING 呼叫,此呼叫會在經過指定的毫秒數或 MAPI 已初始化時傳回 。 INFINITE 可用於無限等候。
IFACEMETHODIMP BeginWait (DWORD 逾時,IMAPIWaitResult ppResult)
- 開始等候MAPI初始化或經過指定的毫秒數。 這會傳回應該呼叫 「End」 的 IMAPIWaitResult 介面,以便開始等候。 這可讓呼叫端控制正在等候時封鎖的線程。
介面 IMAPIWaitResult
IFACEMETHODIMP 結束 () 覆寫
- 呼叫 以在呼叫它的線程上起始封鎖等候,不需要是稱為 “BeginWait” 的相同線程。
先前修改過的內容
已在舊版 Outlook MAPI 參考中新增下列功能的內容:
Microsoft Outlook 2013 允許非傳統的部署案例,例如並存和隨選即用。 這些案例可能會使用來載入適當MAPI連結庫的邏輯變得複雜。 MAPI 開發人員現在可以選擇明確連結至MAPI函式,並可以選擇明確連結至預設MAPI用戶端 (的MAPI存根,例如,Msmapi32.dll Outlook) ,而不需要經過MAPI連結庫和 Windows MAPI 存根。 如需與隱含連結相較之下明確連結的詳細資訊,請參閱 連結至MAPI函式。
MAPI Stub 連結庫張貼在 GitHub 上的 MAPIStubLibrary 上,提供 Mapi32.lib 的下拉式清單,可支援建置 32 位和 64 位 MAPI 應用程式。
支援 64 位Microsoft Outlook— 適用 API 元素的參考主題已更新為對應至支援 64 位 Outlook 的新頭檔。 這些頭文件位於 MAPIStubLibrary。 檢查 Outlook 版本中提供了新的程式碼範例,以示範如何檢查安裝的 Outlook 版本是否為 64 位 Microsoft Outlook 2010,並且已針對 Outlook 2013 進行修訂。 如果您現有的 32 位 MAPI 應用程式即將在已安裝 64 位 Outlook 的 64 位作業系統上執行,您必須將 32 位應用程式重建為 64 位應用程式。 如需 64 位 Outlook MAPI 支援的詳細資訊,請參閱 在 32 位和 64 位平臺上建置 MAPI 應用程式。
訊息存放區提供者範例— 範 例包裝的 PST 存放區提供者 先前已更新為支援 64 位架構。 The Example's Initializing a Wrapped PST Store Provider topic has now been expanded to provide information about the "Wrapped PST and Unicode Paths."
自動完成 Stream- 昵稱快取主題,先前稱為 Nk2 檔格式,已更新以反映 Outlook 2013 和 Outlook 2010 中的變更。 當使用者撰寫電子郵件時,自動完成清單等資訊會儲存到本機計算機上訊息的自動完成 Stream,而不是儲存到 Outlook 2007 中的檔案,以顯示在 [寄件者]、[副本] 和 [密件抄送編輯] 方塊中的名稱清單。
與自動完成 Stream 互動
載入自動完成 Stream
儲存自動完成 Stream
MAPI 用戶端的快速關機支援 — MAPI 用戶端現在可以起始快速關機,並讓 MAPI 子系統通知載入的提供者,以將快速關機的數據遺失降至最低。 已為用戶端和提供者新增其他介面,以支援快速關機。 如需快速關機的詳細資訊,請參閱 MAPI中的用戶端關機。
Stream Outlook 專案的欄位定義結構—已新增 PidLidPropertyDefinitionStream 屬性之二進位數據流的檔。 這個屬性會指定 Outlook 專案內建字位的所有自定義欄位和數據系結設定的定義。
個人存放區覆寫— 已新增下列介面及其各自的方法,以支援覆寫 PST (PST) 存放區提供者 PSTDisableGrow 原則的個人資料夾檔案:
使用多個 Exchange 帳戶— 已新增 MAPI 通訊簿 API 的檔 。 此 API 已增強為在 Microsoft Outlook 2010 中支援多個 Exchange 帳戶,現在包含 Microsoft Outlook 2013。 若要使用多個 Exchange 帳戶正確解析位址,請使用採用帳戶內容的新函式,以便呼叫通訊簿搜尋正確的 Exchange 帳戶。
MAPI 檔格式 - MAPI 組態資訊已展開,以說明如何在 MapiSvc.inf 中註冊服務和服務提供者中使用路徑。
屬性— 除了先前新增的 38 個其他標記屬性和具名屬性的檔之外,還新增了下列已標記的屬性:
MAPI 常數— 合併的 MAPI 常數 已展開。 在舊版中,它們已分散在許多主題中,但現在會收集到單一主題中,讓它們更容易探索和使用。 它們也已擴充,以提供更廣泛的涵蓋範圍,包括下列各節:
Exchange 通訊簿和訊息存放區錯誤碼的定義
信箱快取模式配額 Exchange Server 定義