共用方式為


CreateMAPIInitializationMonitor

適用於:Outlook 2016 |Outlook 2019

MAPI 初始化監視器

有時候,取用 MAPI 的應用程式可能會想要知道初始化何時完成。 例如,它有多個線程可以初始化MAPI,或回應MAPI正在初始化,應用程式會想要執行一些工作,但不想要一律啟動MAPI堆疊。 初始化監視器會透過從 OLMAPI32.DLL) 導出的函式 (,以及下面所述的幾個簡單介面,來提供這項功能。

HRESULT CreateMAPIInitializationMonitor(IMAPIInitMonitor** ppInitMonitor); 

HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor (IMAPIInitMonitor ppInitMonitor)

從 OLMAPI32.DLL 導出的這個進入點可讓呼叫端擷取介面來查詢目前的初始化狀態、設定初始化完成的回呼,或封鎖目前的線程,直到完成為止。 從此 API 傳回的物件可重複使用且具備線程安全,而且可以從任何線程叫用,而不只是擷取它的線程。 此外,不同於從 MAPI 公開的其他物件,只要載入 DLL,這個物件就有效,它可以在初始化會話之間重複使用,而且可以在呼叫 MAPIInitialize 之前或之後使用。 透過 COM 標準 HRESULT 傳回成功或失敗,並將 out 參數指派給 IMAPIInitMonitor 的實例。

參數

ppInitMonitor

[out]指標,用來接收新建立的MAPI初始化監視器實例。

傳回值

S_OK

已成功建立初始化監視器的新實例。

E_OUTOFMEMORY

記憶體不足,無法快取新的物件。

另請參閱

IMAPIInitMonitor

IMAPIWaitResult