共用方式為


此版本的新功能

適用於:Outlook 2013 |Outlook 2016

Microsoft Outlook MAPI 參考已更新為包含各種新功能的檔。

新增內容

已針對下列功能新增內容:

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 原則的個人資料夾檔案:

    IPSTOVERRIDEREQ::IUnknown

    IPSTOVERRIDE1::IUnknown

  • 使用多個 Exchange 帳戶已新增 MAPI 通訊簿 API 的檔 。 此 API 已增強為在 Microsoft Outlook 2010 中支援多個 Exchange 帳戶,現在包含 Microsoft Outlook 2013。 若要使用多個 Exchange 帳戶正確解析位址,請使用採用帳戶內容的新函式,以便呼叫通訊簿搜尋正確的 Exchange 帳戶。

  • MAPI 檔格式 - MAPI 組態資訊已展開,以說明如何在 MapiSvc.inf 中註冊服務和服務提供者中使用路徑。

  • 屬性— 除了先前新增的 38 個其他標記屬性和具名屬性的檔之外,還新增了下列已標記的屬性:

  • MAPI 常數— 合併的 MAPI 常數 已展開。 在舊版中,它們已分散在許多主題中,但現在會收集到單一主題中,讓它們更容易探索和使用。 它們也已擴充,以提供更廣泛的涵蓋範圍,包括下列各節:

    • Exchange 通訊簿和訊息存放區錯誤碼的定義

    • 信箱快取模式配額 Exchange Server 定義

另請參閱

使用 Outlook MAPI 參考 使用者入門

MAPIStubLibrary