IMAPISession：：GetMsgStoresTable

適用於：Outlook 2013 |Outlook 2016

提供訊息存放區數據表的存取權，其中包含會話配置檔中所有訊息存放區的資訊。

HRESULT GetMsgStoresTable(
  ULONG ulFlags,
  LPMAPITABLE FAR * lppTable
);

參數

ulFlags

[in]旗標的位掩碼，決定字元字串之數據行的格式。您可以設定下列旗標：

MAPI_UNICODE

字串資料行是 Unicode 格式。如果未設定MAPI_UNICODE旗標，則字串數據行會是 ANSI 格式。

lppTable

[out]訊息存放區數據表指標的指標。

S_OK

已成功傳回數據表。

MAPI_E_BAD_CHARWIDTH

已設定MAPI_UNICODE旗標，且會話不支援 Unicode。

IMAPISession：：GetMsgStoresTable 方法會擷取訊息存放區數據表的指標，這是MAPI所維護的數據表，其中包含配置檔中每個開啟的訊息存放區相關信息。

如需訊息存放區數據表中必要和選擇性數據行的完整清單，請參閱訊息存放區數據表。

由於 MAPI 會在每次發生變更時於工作階段期間更新訊息存放區數據表，因此請呼叫訊息存放區數據表的 Advise 方法， 以註冊以收到這些變更的通知。可能的變更包括新增訊息存放區、移除現有的存放區，以及變更預設存放區。

在 ulFlags 參數中設定MAPI_UNICODE旗標會影響從 IMAPITable：：QueryColumns 和 IMAPITable：：QueryRows 方法傳回的數據行格式。此旗標也會以 IMAPITable：：QuerySortOrder 方法所傳回的排序順序控制屬性類型。

如需 MFCMAPI 範例程式代碼，請參閱下表。

檔案	Function	Comment
MainDlg.cpp	CMainDlg：：OnOpenMessageStoreTable	MFCMAPI 會使用 IMAPISession：：GetMsgStoresTable 方法來取得訊息存放區數據表，以便在 MFCMAPI 的主要對話框中轉譯。