IMsgStore::GetReceiveFolderTable

适用于:Outlook 2013 | Outlook 2016

提供对接收文件夹表的访问权限,该表包含有关消息存储的所有接收文件夹的信息。

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

参数

ulFlags

[in]控制表访问的标志的位掩码。 可以设置以下标志:

MAPI_DEFERRED_ERRORS

允许 GetReceiveFolderTable 成功返回,可能在表完全可供调用方使用之前返回。 如果表未完全可用,则进行后续表调用可能会引发错误。

MAPI_UNICODE

返回的字符串采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串采用 ANSI 格式。

lppTable

[out]指向接收文件夹表的指针。

返回值

S_OK

接收文件夹表已成功返回。

注解

IMsgStore::GetReceiveFolderTable 方法提供对表的访问权限,该表显示所有消息存储的接收文件夹的属性设置。

针对实现者的说明

有关接收文件夹表中所需列的列表,请参阅 “接收文件夹表”。

实现接收文件夹表,以支持对 PR_RECORD_KEY ( PidTagRecordKey) 属性设置属性限制。 这样便可以轻松访问特定接收文件夹。

给调用方的说明

ulFlags 参数中设置MAPI_UNICODE标志会影响从 IMAPITable::QueryColumnsIMAPITable::QueryRows 方法返回的列的格式。 此标志还按 IMAPITable::QuerySortOrder 方法返回的排序顺序控制属性类型。

MFCMAPI 引用

有关 MFCMAPI 示例代码,请参阅下表。

文件 函数 备注
MsgStoreDlg.cpp
CMsgStoreDlg::OnDisplayReceiveFolderTable
MFCMAPI 使用 IMsgStore::GetReceiveFolderTable 方法获取要显示的接收文件夹表。

另请参阅

IMAPITable::QueryColumns

IMAPITable::QueryRows

IMAPITable::QuerySortOrder

IMAPITable::SetColumns

IMsgStore : IMAPIProp

MFCMAPI 代码示例