關於離線狀態 API

適用於：Outlook 2013 |Outlook 2016

離線狀態 API 支援回呼，指出 Microsoft Outlook 2013 和 Microsoft Outlook 2010 中使用者連線狀態的變更，例如，從 Outlook 2013 或 Outlook 2010 上線到離線。 API 會使用 Outlook 2013 或 Outlook 2010 中的全域離線物件來追蹤指定使用者帳戶設定檔的這類變更。 通知是唯一支援的回呼形式。 作為此 API 的用戶端，想要收到這類連線狀態變更通知的郵件提供者會執行下列動作：

1. 實 作 IMAPIOfflineNotify。

2. 使用 HrOpenOfflineObj 開啟特定配置檔的現有離線物件。

3. 判斷物件是否能夠使用 IMAPIOffline：：GetCapabilities 提供在線或離線通知。

4. 使用 IMAPIOfflineMgr：：Advise 註冊在線或離線通知的物件。 郵件提供者現在可以使用 IMAPIOfflineNotify 接收 Outlook 2013 或 Outlook 2010 傳送的通知。

5. 關機時，請使用 IMAPIOfflineMgr：：Unadvise 移除在線和離線通知的註冊。

注意事項

一般而言，Outlook 2013 和 Outlook 2010 可以通知用戶端在線/離線變更以及其他變更，但離線狀態 API 只支援在線/離線變更的通知。 客戶端應該忽略所有其他通知。 如需詳細資訊，請參閱 IMAPIOfflineNotify：：Notify 和 MAPIOFFLINE_NOTIFY。

如需使用離線狀態 API 的用戶端範例，請參閱 關於離線狀態載入宏範例。 範例脫機狀態載入宏是使用離線狀態 API 來監視和變更連線狀態的 COM 載入宏。

此 API 提供下列專案：

定義：

• MAPI 常數

資料類型：

• MAPIOFFLINE_ADVISEINFO

• MAPIOFFLINE_CALLBACK_TYPE

• MAPIOFFLINE_NOTIFY

函數

• HrOpenOfflineObj

介面

• IMAPIOffline

• IMAPIOfflineMgr

• IMAPIOfflineNotify