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 引用
有关 MFCMAPI 示例代码，请参阅下表。
| 文件 | 函数 | Comment |
|---|---|---|
| MainDlg.cpp |
CMainDlg：：OnOpenMessageStoreTable |
MFCMAPI 使用 IMAPISession：：GetMsgStoresTable 方法获取消息存储表，以便可以在 MFCMAPI 的“main”对话框中呈现该表。 |